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About This Manual 



This manual describes magnetic tape operations on a system using the NOS Tape 
Management System (TMS). TMS can operate on the following systems: 

CONTROL DATA® CYBER 180 Computer Systems 

Models 810, 830, 835, 840, 845, 850, 855, 860, 870, 960, 970, 990, 994, and 995 

CONTROL DATA CYBER 170 Computer Systems 

Models 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 760, 815, 825, 835, 845, 
855, 865, and 875 

CONTROL DATA CYBER 70 Computer Systems 

Models 71, 72, 73, and 74 

CONTROL DATA 6000 Computer Systems 

Audience and Organization 

This manual is written for a tape librarian or individuals at the central site who are 
responsible for managing tapes. It should be used in conjunction with the NOS central 
site manuals: the Administration Handbook, Analysis Handbook, Installation Handbook 
and Operations Handbook. 

Section 1 provides general information about TMS. Section 2 describes how to initiate 
MAGNET and enable TMS. Section 3 describes the tape file supervisor (TFSP). Section 
4 describes the tape display utility provided by TMS. Section 5 describes the procedures 
that allow you to perform various functions with a tape catalog file. 

Conventions 

Unless otherwise stated, it is assumed that you are using the batch subsystem when 
you enter commands from an interactive terminal. 

Uppercase characters within command formats are interpreted literally. Lowercase 
characters are variables and are described immediately following the line that shows 
the command format. 

New features, as well as changes, deletions, and additions to this manual, are indicated 
by vertical bars in the margins. 
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Submitting Comments 

There is a comment sheet at the back of this manual. You can use it to give us your 
opinion of the manual's usability, to suggest specific improvements, and to report 
errors. If the comment sheet has already been used, mail your comments to: 

Control Data 

Technical Publications ARH219 
4201 Lexington Avenue N. 
St. Paul, MN 55126-6198 

Please indicate whether you would like a response. 

If you have access to SOLVER, the Control Data online facility for reporting problems, 
you can use it to submit comments about this manual. When entering your comments, 
use TMS as the product identifier. Include the name and publication number of the 
manual. 

If you have questions about the packaging and/or distribution of a printed manual, 
write to: 

Control Data 
| Literature and Distribution Services ARHLDS 

| 4201 Lexington Avenue N. 

| St. Paul, MN 55126-6198 

| You can also call (612) 482-3800 or (612) 482-3801, or FAX your inquiry to (612) 
| 482-3813. (If you are a Control Data employee, use the Controlnet number 235-3800 
| 235-3801, or 235-3813.) 

Central Software Support Hotline 

Control Data's Central Software Support maintains a hotline to assist you if you have 
trouble using our products. If you need help not provided by the documentation, or find 
the product does not perform as described, call one of the following numbers. A support 
analyst will work with you. 

| From the USA and Canada: (800) 345-6628 



§ 



| From other locations: (612) 482-3434 
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Related Publications 

The following manuals contain additional information about NOS that may prove useful 
to you. These manuals are available through Control Data sales offices or Control Data 
Literature Distribution Services, 4201 Lexington Avenue N., St. Paul, MN 55126-6198. 



Manual Title 



Publication 
Number 



NOS Version 2 Tape Management System User Reference Manual 

NOS Version 2 Administration Handbook 

NOS Version 2 Analysis Handbook 

NOS Version 2 Installation Handbook 

NOS Version 2 Operations Handbook 

NOS Version 2 Reference Set, Volume 3, System Commands 

NOS Version 2 Reference Set, Volume 4, Program Interface 

NOS Version 2 Security Administrator's Handbook 



60463110 
60459840 
60459300 
60459320 
60459310 
60459680 
60459690 
60460410 



You might also want to consult the NOS System Information Manual. It is an online 
manual that includes brief descriptions of all NOS and NOS product manuals. You can 
access this manual by logging into NOS and simply entering the command EXPLAIN. 

Disclaimer 

This product is intended for use only as described in this document. Control Data 
cannot be responsible for the proper functioning of undescribed features or undefined 
parameters. 
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Introduction 



Non-TMS Tape Processing 1 ' 1 

TMS Tape Processing l ' 2 



Introduction 



The NOS Tape Management System (TMS) is a software subsystem that allows a 
computer center and its users to efficiently manage magnetic tape usage. TMS 
commands permit tape owners to select security options and permit alternate users to 
access their tapes. TMS establishes a database of available tapes, tape owners, and 
alternate user access permission. The database keeps track of what users own specific 
tapes and enforces the security options tape owners select. TMS commands also 
simplify the user's tape processing interface. 

TMS consists of eight user commands: six new commands and two changed NOS 
commands. Four NOS tape handling commands are not needed with TMS. Table 1-1 
lists TMS and NOS commands and their relationships. TMS maintains compatibility 
with the standard NOS commands by allowing non-TMS processing. The differences 
between non-TMS tape processing and TMS tape processing are described briefly in the 
following paragraphs. 



Table 1-1. TMS Commands Versus Standard NOS Tape Commands 
TMS Commands NOS Commands 1 Notes 



ADMIT 


— 


Added by TMS. 


AMEND 


— 


Added by TMS. 


— 


ASSIGN 


Not used with TMS 


AUDIT 


— 


Added by TMS. 


— 


BLANK 


Not used with TMS 


LABEL 


LABEL 


Changed by TMS. 


RECLAIM 


RECLAIM 


Changed by TMS. 


RELEASE 


— 


Added by TMS. 


RESERVE 


— 


Added by TMS. 


— 


REQUEST 


Not used with TMS 


TMSDEF 


— 


Added by TMS. 


^_ 


VSN 


Not used with TMS 



1. Other NOS commands that apply to magnetic tape operations, such as LISTLB, 
RESOURC, RETURN, TCOPY, and UNLOAD are unchanged by TMS and are described 
in the NOS 2 Reference Set, Volume 3. 

Non-TMS Tape Processing 

When the system is run with TMS disabled, you cannot use the tape file supervisor 
(TFSP) and users cannot issue TMS commands. When a user is running without TMS 
processing, the operator is required to verify, mount, and assign tapes requested by the 
user. 
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TMS Tape Processing 



TMS Tape Processing 

TMS allows users to create and access tape files. When the system is run with TMS 
enabled, users can choose to run with or without TMS processing. When a user is 
running with TMS processing, the system automatically assigns scratch tapes and 
verifies that the user is allowed to access the requested tapes. When a user is running 
without TMS processing, the operator is required to verify, mount, and assign tapes 
requested by the user. 

You can use the tape file supervisor (TFSP) to create, update, and manage the TMS 
tape catalog file. The TFSP command can be used to create, update, and obtain 
information from the tape catalog file. TFSP can access the family tape catalog file 
only if it is called from a system origin job or from a job that has a user name that 
has been validated to access the file. 

You can use the tape display utility (TMSDIS) as a replacement for the NOS DSD 
displays and commands for a system that runs with TMS. TMSDIS can be used as an 
L-display utility from the system console or from non-system origin jobs by validated 
users. 

The following five TMSDIS displays allow you to display tape equipment and TMS 
catalog information: 

TMSDIS Display Function __ 

Help Display Lists input commands. 

Tape Equipment Display Lists the status of each tape equipment on the system. 
Executing Job Display Identifies jobs that have made tape requests. 

Family Catalog Display Lists the information for each family's tape catalog. 

Preview Display Identifies tapes and packs required to satisfy a user's 

resource requests. 
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TMSOFF Command 2 " 4 



Initiating the Magnetic Tape Executive 2 

The magnetic tape executive, MAGNET, can be initiated by a DSD command at the 
system console. For example, if the command 

MAGffff. 

is issued at the console, the system attempts to get the indirect access permanent file 
MAGffff (where ffff is an optional, 1- to 4-character, site-defined suffix) from the system 
user index and execute it as a procedure. 

If the indirect access permanent file is not found, the system attempts to execute the 
system procedure MAGffff. 

If the AUTO or MAINTENANCE command is issued while MAGNET is enabled, the 
system automatically issues the following command: 

MAG. 

To initiate the magnetic tape executive, the procedure should issue the MAGNET 
command and should have EXIT processing so that the MAGNET1 command is called 
in case MAGNET aborts. 

The system procedure MAG contains the following commands: 

TMSON , FM=* , DEFTO=TC , DEFTOS=FC . 

MAGNET. 

MAGNET 1. 

EXIT. 

MAGNET 1. 

Enabling TMS 

TMS is disabled by default when a system is deadstarted. TMS is enabled when 
ENABLE, TMS is specified in the IPRDECK. TMS is also enabled if the TMSON 
command is included in the procedure that initiates the magnetic tape executive. Once 
TMS is enabled, it cannot be disabled without deadstarting the system. 

Running with TMS Disabled 

When a system is run with TMS disabled, users cannot issue TMS commands (such as 
AUDIT and RESERVE), you are not able to use the tape file supervisor (TFSP), and 
the TMS parameters (such as UN and TO) on the LABEL and REQUEST commands 
are ignored. 
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Running with TMS Enabled 

When a system is run with TMS enabled, a user can choose whether a tape request 
should be run with or without TMS processing. This is done by way of the TO 
parameter on a LABEL or REQUEST command. The site can specify the default for 
the TO parameter on the LABEL and REQUEST commands using the TMSON 
command. In addition, the site can specify that system origin and nonsystem origin jobs 
have different defaults for the TO parameter. The user can override the system default 
for the TO parameter using the TMSDEF command. 

When a user is running with TMS processing, the system automatically assigns scratch 
tapes and verifies that the user is allowed access to requested tapes. Generally, the 
operator mounts only the tapes listed by the executing job. 

When a user is running without TMS processing, the operator is required to verify, 
mount, and assign tapes requested by the user. 

TMS Commands 

Two TMS commands control the enabling or disabling of TMS: 
TMSON 
TMSOFF 

TMSON Command 

The TMSON command can be called from system origin jobs to enable TMS for the 
system, to turn on TMS tape catalog files for families on the system, and to define 
default TMS parameter values for the LABEL and REQUEST commands (refer to the 
NOS 2 Tape Management System User Reference Manual). 

Format: 

TMSON , FM=f name , DE FTOnopt , DEFT0S=SOPt . 

Parameter Description 

FM=fname Family name of TMS catalog to turn on. If a specific family name 

or is used and the TMS catalog for that family cannot be turned on, 

FM = * TMSON aborts. If an asterisk (*) is used, TMSON attempts to turn 

on the TMS catalogs on all families of the system. An informative 
message is issued if TMSON cannot turn on a TMS catalog for a 
family. This parameter is required. 
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TMS Commands 



Parameter 



Description 



DEFTO=nopt 



Identifies the default tape option (the TO parameter) for LABEL 
and REQUEST commands for nonsystem origin jobs. This 
parameter can be specified only if the calling job is running with 
the subsystem identification of MAGNET (MTSI). Valid entries for 
nopt are: 



Sets the default to TO=T (TMS processing). 



Sets the default to TO=F (non-TMS processing). 



DEFTOS=sopt 



Sets the default to TO=C (check for catalog error). 

E 

Sets the default to TO=E (ignore catalog error). 

If this parameter is not specified, TMSON does not change the 
default tape option. A user can change the default tape option for a 
job by using the TMSDEF command. 

Identifies the default tape option (the TO parameter) for LABEL 
and REQUEST commands for system origin jobs. This parameter 
can be specified only if the calling job is running with the 
subsystem identification of MAGNET (MTSI). Valid entries for sopt 
are: 



Sets the default to TO=T (TMS processing). 



Sets the default to TO=F (non-TMS processing). 



Sets the default to TO = C (check for catalog error). 

E 

Sets the default to TO = E (ignore catalog error). 

If this parameter is not specified, TMSON does not change the 
default tape option. A user can change the default tape option for a 
job using the TMSDEF command. 

If TMSON is called from a job with the subsystem identification of MAGNET (MTSI), 
TMSON enables TMS for the system. TMS must already be enabled if TMSON is 
called from a job that does not have the subsystem identification of MAGNET. 

NOTE 

The TMSON command fast-attaches the tape catalog on a family. If you need to 
initialize or unload a device with a fast-attached tape catalog, issue the TMSOFF 
command to take the tape catalog out of fast-attached status. 
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TMSOFF Command 

The TMSOFF command can be called from system origin jobs to turn off TMS tape 
catalog files for a specific family or for all families on the system. 

Format: 

TMSOFF, FM=f name. 

Parameter Description 

FM=fname Family name of TMS catalog to turn off. If a specific family name 

or is used and the TMS catalog for that family cannot be turned off, 

FM = * TMSOFF aborts. If an asterisk (*) is used, TMSOFF attempts to 

turn off the TMS catalogs on all families of the system. An 
informative message is issued if TMSOFF cannot turn off a TMS 
catalog for a family. This parameter is required. 

A TMS catalog can be turned off only if there is no activity on the specified family. 
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The tape file supervisor (TFSP) includes the TFSP command, TFSP input/source file 
directives, TFSP audit directive output formats, and TFSP machine-readable file 
formats. 

TFSP Command 

TFSP creates and manages the tape catalog file. The TFSP command creates, updates, 
and obtains information from the tape catalog file. TFSP directives can be entered by a 
local file, command comment field, or K-display entry. Information on the tape catalog 
file can be written to local files, the K display, or terminal. 

TFSP can manipulate either the family tape catalog file (a fast-attached file named 
ZZZZZFC on user index 3777778) or local file images of the tape catalog file. 

TFSP can access the family tape catalog file only if it is called from a system origin 
job or if it is called from a job that has a user name that has been validated to access 
the file. Only one TFSP job can access a tape catalog file of a family at one time. 
However, several TFSP jobs can access tape catalog files of different families at the 
same time. 

Format: 

TFSP(p1,p2 pn) Z option directives 

where each parameter is a keyword or a keyword equated to a value. 

pi Description 

I = infile Input file containing TFSP directives. Ignored if you specify OP = K 

or OP = Z. If 1 = 0, no input file is used. Default is I = INPUT. 

L = outfile Output file. TFSP lists input directives, errors encountered, and 

information as specified by the audit directives (AUDITUN, 
AUDITVS, AUDITCN, AUDITFI, AUDITFV, and AUDITAU). If 
L=0, no output file is generated. Default is L = OUTPUT. 

P = oldfile Old tape catalog file. Ignored except for local file (LF) mode. If 

P=0, a new tape catalog file is created. Default is P = OLD. 

N = newfile New or updated tape catalog file. Ignored except for local file (LF) 

mode. If P = 0, the default is N = NEW. If P = oldfile, the default is 
N = oldfile. 

S=sourcefile Source file to receive TFSP input directives generated from 

information on the tape catalog file. The source file is generated by 
the source directives (SOURCE, SOURCUN, SOURCVS, SOURCCN, 
SOURCFI, and SOURCFV). If S=0, no source file is generated. 
Default is S= SOURCE. 

SS=mrfile Machine-readable file. TFSP lists information to mrfile in 

machine-readable format as specified by the machine-readable audit 
directives (MREADUN, MREADVS, MREADCN, MREADFI, and 
MREADFV). If SS=0, no machine-readable file is generated. 
Default is SS=0. 
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TFSP Command 



Pi 



Description 



OP = option 



Specifies the input mode for directives. Valid entries are: 

I 

Read TFSP directives from the file specified by the I parameter. 

K 

Read TFSP directives from K-display input. Display tape catalog 
file information at the K display. Valid only for system origin 
jobs. 



LF 



NV 



RT 



FM= family 



Read TFSP directives from the delimited string following the 
command terminator. The first character following the 
terminator is assumed to be the delimiter. 

Default is OP = I. 

Local file mode. If specified, TFSP accesses and updates the local 
files specified by the P and N parameters. If not specified, TFSP 
accesses and possibly updates the fast-attached file ZZZZZFC on 
user index 377777s. For nonsystem origin jobs, if the LF parameter 
is not specified, TFSP aborts if the user is not validated to access 
the family tape catalog file using the VALIDAT directive. 

Abort mode. If specified, TFSP aborts when the first error is 
encountered while processing the directives. If not specified, TFSP 
issues an error message to the output file and dayfile but continues 
processing with the directives on the next line of input. Abort mode 
is usually selected when TFSP is run with noninteractive input 
such as running TFSP in a batch origin job. Abort mode is usually 
not selected when TFSP is run with interactive input such as 
running TFSP with the K-display or from an interactive terminal. 

No verify mode. Ignored except for local file (LF) mode or if not 
creating new tape catalog file (P=0). If specified, TFSP does not 
check the status of VSNs specified by the VSN directive, tape files 
specified by the FILE or FILEV directive, or alternative users 
specified by the AUSER directive. This can speed processing of 
large TFSP input files. However, this can also create errors in the 
tape catalog file if the input file is set up incorrectly. 

Retry on catalog interlock option. Ignored for local file (LF) mode. 
If specified, TFSP does not abort if the fast-attached tape catalog 
file is interlocked by another TFSP job. TFSP waits until the other 
job is complete so it can access the tape catalog file. Generally, the 
retry option is selected when TFSP is run in a procedure file or in 
a batch origin job. 

Family on which the tape catalog file resides. Invalid entry for a 
nonsystem origin job or if in local file (LF) mode. Default is the 
family of the calling job. A nonsystem origin job is forced to access 
the tape catalog file for its family. 
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TFSP Command 



Examples of TFSP Use 

The following examples show how a site might use TFSP under control of DIS. 

Example 1 

This example creates a tape catalog file for family FAM based on directives in file 
IFILE. 

FAMILY, FAM. 

SUI ,377777. 

TMSOFF,FM=FAM. 

PURGE, ZZZ2ZFC/NA. 

RETURN, ZZZZZFC. 

DEFINE,NEW=ZZZZZFC. 

TFSP(OP=I,I=IFILE,LF,P=0) 

RETURN, NEW. 

TMSON,FM=FAM. 

Example 2 

This example shows how TFSP can act as a tape file counterpart of PFDUMP by using 
source directives. The source file can then be used as an input file to be the 
counterpart to PFLOAD. The catalog entries for the tape files of user name USERl are 
dumped and purged from family ABC and loaded onto family XYZ. 

TFSP (OP=Z , S=DUMP , FM=ABC ) /SOURCUN=USER 1/PURGALL=USER1 

REWIND, DUMP. 

TFSP(OP=I,I=DUMP,FM=XYZ) 

Example 3 

This example restructures the tape catalog file on family FAM. When a large number 
of entries have been created, updated, and deleted from the tape catalog file, the 
physical structure of the tape catalog file may have changed to an extent to cause a 
negative impact on system performance. Like the MODVAL validation file, the tape 
catalog file can be taken back to source and then recreated to obtain optimum file 
structure. 

FAMILY, FAM. 

SUI, 377777. 

TMSOFF,FM=FAM. 

ATTACH ,OLD=ZZZZZFC/M=W . 

TFSP(OP=Z,LF,S=SFILE)/SOURCE 

RENAME,NEW=OLD. 

REWIND, SFILE. 

TFSP(OP=I , I=SFILE , LF , P=0, NV) 

RETURN , NEW . 

TMSON,FM=FAM. 
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TFSP Command 



Example 4 

The TFSP audit directives provide a counterpart to PFCAT. The audit directives 
provide information on any or all entries in the tape catalog file. This example shows 
how a full list of information on each tape file entry in the tape catalog file for family 
FAM is sent to the printer. 

TFSP(OP=Z,FM=FAM,L=LIST)/AUDITUN= 
ROUTE, LIST, DC=PR. 

TFSP Input/Source File Directives 

TFSP directives are divided into five categories: family level, VSN level, user level, file 
level, and alternate user level. Figure 3-1 shows which directives can be used on which 
levels. Generally, higher level directives are valid on lower levels. 

Higher level directives that are not honored from a lower level are those which allow 
immediate updates to be made against VSNs, tape files, or user names other than the 
one under which the user is currently working (ISV, PURGALL, PURGE, RELEASE, 
RELEASF, RELEASV, REMOVE). 



I 
FAMILY LEVEL 

Family level 

directives val id. 

1 
I I 

USER LEVEL VSN LEVEL 

User, most family VSN, most family 

level directives level directives 

va 1 i d . va 1 i d . 







1 






FILE 


LEVEL 






File 


most 


user, 




most 


fami ly 


level 


) 

ALTERNATE L 


directives 
1 


valid. 


ISER LEVEL 


Alternate user. 






fi le, most 


user, 






most family 






directives 


valid. 







Figure 3-1. Diagram of Level Structure 
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TFSP Command 

General Rules for Input Directives 

In general, TFSP directives consist of a keyword or a keyword equated to a value. 

Each directive line of input is free format through column 72. Any data beyond column 
72 is ignored. All numeric data is assumed to be decimal unless a B post-radix is used 
to specify octal. 

The following rules apply to TFSP directives. 

• Some TFSP directives consist of a keyword equated to a value. For example: 

VSN=V1 

If the value is not specified, the default value is set if the directive has a default. 
For example: 

NS= 
is the same as: 

NS=18 
where 18 is the default value for NS. 

• Other TFSP directives consist only of a keyword and are not equated. For example: 

HELP 

• In general, TFSP directives can be separated by a nonalphanumeric character, an 
end-of-line, or an end-of-card. For example: 

VSN=V1 
ERRFLAG=SET+OWNER=USER ; ADD 

is the same as: 

VSN=V1 
ERRFLAG=SET 
OWNER=USER 
ADD 

• Usually, spaces in a TFSP directive input line are ignored. For example: 

VS N = v i 

is the same as: 

VSN=V1 

However, the PRN, FI, PI, SI, and UC directives accept spaces and all other 
nonalphanumeric characters as valid input. 
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• The SEPARAT directive is available to force one nonblank, nonalphanumeric 
character to be interpreted as a separator. For example: 

SEPARAT=* 

UC=A B,SI=*FA=A 

SEPARAT= , 

UC=A B,SI=*FA=A 

is the same as: 

UC=A B,SI= 
FA=A 
UC=A B 
SI=*FA=A 

• Entry of a colon character in the input file can cause unpredictable results. The 
COLON directive is available to force a nonalphanumeric character to be 
interpreted as a colon. For example: 

COLON=) 
UC=AB)XX 

is the same as: 

UC=AB : XX 

• If a directive keyword is one, two, or three characters long, the entire keyword 
must be spelled out. If a keyword is more than three characters long, at least the 
first three characters must be specified plus any additional characters needed to 
make the directive unique. For example: 

AUDITV=V1 

AUDITU=USER1 

VAL=USER2 

is the same as: 

AUDITVS=V1 

AUDITUN=USER1 

VALIDAT=USER2 

However, VA=USER2 would be invalid because the keyword is less than three 
characters. AUDIT = VI would be invalid because the keyword would not be unique. 

• Some directives have a specific set of options that can be entered as a value. Only 
enough characters to uniquely identify the option must be specified as a value. For 
example: 

CT=PR 

CT=S 

CT=PU 

is the same as: 

CT=PRIVATE 

CT=SPRIV 

CT=PUBLIC 

However, CT=P is invalid because the value is not unique. 
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Example of Input Directive Stream 

VSN=V00001 
PRN=VABC 
ADD 

VSN=T0001A,ADD 
USER=USER1 
FILE=FILE1 

CT=PU,CN=CHARGE1 
AVSN=V00001 
RESERVE 
FILEV=T0001A 
M=W 
AUSER=USER2 

AMODE=N 
ADMIT 
AMEND 
DROP "* 

USER=USER2 

S0URCCN=CHARGE2 
DROP 
DROP 

TFSP Directive Processing Options 

The following TFSP directive processing options are available. 

Directive Description 

OP = I TFSP reads the directives from the file specified by the I parameter 

until an end-of-record, end-of-file, end-of-information, or family level 
DROP directive is encountered. The file is not rewound before or 
after TFSP reads it. 

If abort mode (the A parameter) is specified, TFSP aborts on the 
first error encountered. If abort mode is not specified, TFSP 
continues processing with the directives on the next line of input. 

OP = Z TFSP reads the directives in the delimited string following the 

command terminator. The first character following the string is the 
delimiter and must not appear within any of the directives. The 
directives may be separated by the delimiter or any valid directive 
separator. Error processing is the same as for the OP = I option. 

OP = K TFSP reads the directives from K-display input. If a directive error 

occurs, TFSP issues a message to the K display, ignores the rest of 
the directives on the input line, and waits for a correct directive. 
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TFSP Displays 

There are the five TFSP displays available for the OP = K option and output. One of 
these displays or the HELP display appears on the left screen of the K display. The 
output file gets a display only if the DISPLAY or HELP directive is issued from any 
option other than the OP = K option. 



Display 



Description 



Family Level 



VSN Level 



User Level 



File Level 



Alternate User 
Level 



This display appears initially for TFSP. It displays the family 
name, machine identification, global status, foreign status, current 
tape file management message buffer for the family if not in local 
file (LF) mode, and user names validated to access the tape catalog 
file using TFSP. See figures 3-2 and 3-3. 

This display appears when a VSN directive is issued. It displays 
information about an unassigned VSN. The display is terminated by 
an ADD, REVISE, DROP, or GO directive. See figures 3-4 and 3-5. 

This display appears when a USER directive is issued. It displays a 
short list of all tape file entries belonging to the user. If all files 
cannot be displayed at one time, a plus ( + ) character in column 1 
of the input line will toggle the display to the next group of files. 
Symbolic access files are listed by file identifier and nonsymbolic 
access files are listed by first VSN and sequence number. The 
display is terminated by a user level DROP or GO directive. See 
figures 3-6 and 3-7. 

This display appears when a FILE or FILEV directive is issued. It 
displays a full list of the tape file entry to be processed. It consists 
of three pages that can be toggled by a plus ( + ) character in 
column 1 of the input line. The display is terminated by an 
AMEND, REVISE, DROP, or GO directive. See figures 3-8, 3-9, 
3-10, and 3-11. 

This display appears when an AUSER directive is issued. It 
displays permission information for the user specified. The display 
is terminated by an ADMIT, DROP, or GO directive. See figures 
3-12 and 3-13. 
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•TFSP* - TAPE FILE SUPERVISOR. 

SEPARATE SEPARATOR CHARACTER. (0-1 CHARACTERS.) 

COLON = COLON CHARACTER. (0-1 CHARACTERS.) 

READ = ALTERNATE INPUT FILE. 

FAMNAME=SKD FAMILY NAME. (1-7 CHARACTERS) 

LINKFAM= LINKED CATALOG FAMILY. (1-7 CHARACTERS) 

MID =32 MACHINE ID. (2 CHARACTERS) 

CATERR =CLEAR ERROR STATUS. (CLEAR, SET) 

FOREIGN=NO FOREIGN STATUS. (NO, YES) 

GLOBAL =NO GLOBAL STATUS. (NO, YES) 



CURRENT MESSAGE BUFFER 



CATALOG SIZE = 00000079. MT/NT SCRATCH COUNT = 00000070. 
CT SCRATCH COUNT = 00000007. AT SCRATCH COUNT = 00000011. 

USER NAMES VALIDATED TO ACCESS 
TAPE CATALOG FILE VIA *TFSP* - 

TOSLJT TMSUN1 TMSUN2 



FAMILIES PERMITTED TO ACCESS CATALOG 

SFT 

WAITING FOR INPUT. 



mm 
mm 
Sis 
III! 



; 

lit 

ill 

ii 



Figure 3-2. Example of Family Level Left Screen K Display 
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*TFSP* - FAMILY LEVEL *HELP* DISPLAY. 



HELP 

DISPLAY 

SEPARAT 



CHAR 



COLON = CHAR 
READ = FILEKAM 
REWIND = FILENAM 
BRIEF/NOBRIEF 
STOP 

AUDITCH = CHARGNO 
AUDITUN = USERNAM 
AUDITVS = VSN 
MREADCH = CHARGNO 
MREADUN = USERNAM 
MREADVS = VSN 
SOURCCH = CHARGNO 
SOURCUN = USERNAM 
SOURCVS = VSN 
SOURCE 

RELEASE = VSN 
REMOVE = VSN 
PURGALL = USERNAM 
PURGE = VSN 
VALIDAT = USERNAM 
INVALID = USERNAM 
ALTFAM = FAMILY 
CALTFAM = FAMILY 
ISV 

VSN = VSN 
USER = USERNAM 
DROP 
GO 



DISPLAY LEGAL DIRECTIVES. 

TOGGLE OUT OF "HELP* DISPLAY. 

SET SEPARATOR CHARACTER. 

DEFAULT IS COMMA. 

SET COLON CHARACTER. DEFAULT IS NONE. 

READ DIRECTIVES OFF OF LOCAL FILE. 

REWIND LOCAL FILE. 

ENABLE/DISABLE INFORMATIVE OUTPUT. 

TERMINATE TFSP. 

AUDIT BY CHARGE NUMBER. 

AUDIT USER. DEFAULT IS ALL USERS. 

AUDIT VSN. DEFAULT IS ALL VSNS. 

MACHINE READABLE *AUDITCH*. 

MACHINE READABLE *AUDITUN*. 

MACHINE READABLE *AUDITVS*. 

SOURCE OF CHARGE NUMBER. 

SOURCE OF USER. DEFAULT IS ALL USERS. 

SOURCE OF VSN. 

SOURCE OF ALL OF TAPE CATALOG FILE. 

RELEASE VSN AND ITS TAPE FILE. 

REMOVE VSN FROM TAPE CATALOG FILE. 

RELEASE ALL TAPE FILES OF USER. 

PURGE TAPE FILES CONTAINING VSN. 

VALIDATE USER TO USE *TFSP*. 

INVALIDATE USER TO USE *TFSP*. 

ALLOW ALTERNATE FAMILY ACCESS. 

DISALLOW ALTERNATE FAMILY ACCESS. 

INITIALIZE SCRATCH VSN. 

BEGIN VSN LEVEL DIRECTIVES. 

BEGIN USER LEVEL DIRECTIVES. 

TERMINATE *TFSP*. 

MAKE UPDATES AND TERMINATE TFSP. 



Figure 3-3. Example of Family Level Right Screen K Display 
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*TFSP» 



TAPE FILE SUPERVISOR. 



SEPARAT=, 

COLON = 

READ 

VSN = T0OO01 



SEPARATOR CHARACTER. (0-1 CHARACTERS.) 
COLON CHARACTER . (0-1 CHARACTERS . ) 
ALTERNATE INPUT FILE. 



VSN CURRENTLY IS IN CATALOG. 



VT 


=MTNT 


PRN 


=T00001 


STATUS 


=AVAILA 


SITE 


=ON 


OWNER 


=CENTER 


SYSTEM 


=NO 


USAGE 


=00 



TAPE TYPE. (MTNT, CT, OR AT) 

PHYSICAL VSN (PRN). (1-6 CHARACTERS) 

STATUS. (AVAILABLE, CLEANED, HOLD, ERROR) 

SITE STATUS. (ON, OFF) 

OWNERSHIP TYPE. (CENTER, USER) 

SYSTEM VSN FLAG. (NO, YES) 

USAGE COUNTER. (0-63) 



WAITING FOR INPUT. 



'INFORM* VSN CURRENTLY IS IN CATALOG. 



m 



- 

III 



Figure 3-4. Example of VSN Level Left Screen K Display 



*TFSP* 

HELP 
DISPLAY 
SEPARAT = CHAR 

COLON = CHAR 

READ = FILENAM 

REWIND = FILENAM 

BRIEF/NOBRIEF 

STOP 

ADD 

REVISE 

DROP 

GO 



VSN LEVEL "HELP* DISPLAY. 

DISPLAY LEGAL DIRECTIVES. 

TOGGLE OUT OF "HELP" DISPLAY. 

SET SEPARATOR CHARACTER. 

DEFAULT IS COMMA. 

SET COLON CHARACTER. DEFAULT IS NONE. 

READ DIRECTIVE OFF OF LOCAL FILE. 

REWIND LOCAL FILE. 

ENABLE/DISABLE INFORMATIVE OUTPUT. 

TERMINATE TFSP. 

PROCESS ADDING VSN TO CATALOG. 

PROCESS REVISING VSN IN CATALOG. 

IGNORE ADD/REVISE OR VSN. 

ADD OR REVISE VSN. 



Figure 3-5. Example of VSN Level Right Screen K Display 
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•TFSP* - TAPE 


FILE SUPERVISOR. 


SEPARAT=, 


SEPARATOR CHARACTER (0-1 CHARACTERS). 


COLON = 


COLON CHARACTER (0-1 CHARACTERS). 


READ = 


ALTERNATE INPUT FILE. 


USER = TOSBAB 




TAPE FILES - 




BB0001/1 


BB0002/1 BB0003/1 


BB0004/1 


FILE1 FILE2 


FILE3 


FILE4 TEST 


MT1 


MT2 



Figure 3-6. Example of User Level Left Screen K Display 



•TFSP* 

HELP 
DISPLAY 
SEPARAT = CHAR 



COLON = CHAR 
READ = FILENAM 
REWIND - FILENAM 
BRIEF/NOBRIEF 
STOP 

AUDITCN = CHARGNO 
AUDITFI = FILEID 
AUDITFV = VSN 
MREADCN = CHARGNO 
MREADFI = FILEID 
MREADFV = VSN 
SOURCCN = CHARGNO 
SOURCFI = FILEID 
SOURCFV = VSN 
RELEASF = FILEID 
RELEASV = VSN 
FILE = FILEID 
FILEV = VSN/QN 
DROP 



USER LEVEL *HELP* DISPLAY. 



DISPLAY LEGAL DIRECTIVES. 

TOGGLE OUT OF *HELP* DISPLAY. 

SET SEPARATOR CHARACTER. 

DEFAULT IS COMMA. 

SET COLON CHARACTER. DEFAULT IS NONE. 

READ DIRECTIVES OFF OF LOCAL FILE. 

REWIND LOCAL FILE. 

ENABLE/DISABLE INFORMATIVE OUTPUT. 

TERMINATE TFSP. 

AUDIT TAPE FILES WITH CHARGE NUMBER. 

AUDIT TAPE FILE. 

AUDIT TAPE FILES WITH VSN. 

MACHINE READABLE *AUDITCN*. 

MACHINE READABLE * AUDITFI*. 

MACHINE READABLE *AUDITFV*. 

SOURCE OF TAPE FILES WITH CHARGE NUMBER. 

SOURCE OF TAPE FILE. 

SOURCE OF TAPE FILES WITH VSN. 

RELEASE BY TAPE FILE. 

RELEASE BY VSN. 

BEGIN FILE LEVEL DIRECTIVES. 

BEGIN FILE LEVEL DIRECTIVES. 

END USER LEVEL DIRECTIVES. 



Figure 3-7. Example of User Level Bight Screen K Display 
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SEPARAT= 


9 


COLON 


= 




READ 


= 




USER 


= 


TOSBAB 


FVSN 


= 


BB0005 


QN 


= 


0001 


FILE 


= 


FILE1 



SV =SET 

RECOVER=YES 

CN =EEEEEEE034 

PN 

CE =CLEAR 
UC =:::::::::: 
TSITE =0N 
URDATE = 
TOWNER =CENTER 
ASSIGNED VSNS - 
BB0005 



•TFSP* - TAPE FILE SUPERVISOR. 

SEPARATOR CHARACTER (0-1 CHARACTERS). 
COLON CHARACTER (0-1 CHARACTERS). 
ALTERNATE INPUT FILE. 



PAGE 1 OF 3 

FILE CURRENTLY IS RESERVED. 

SYMBOLIC ACCESS (NO, SET). 
RECOVERED STATUS (NO, YES). 
CHARGE NUMBER (0-10 CHARACTERS). 

PROJECT NUMBER. 
(0-20 CHARACTERS.) 
ERROR FLAG (CLEAR, SET). 
USER CONTROL WORD (0-10 CHARACTERS) 
SITE STATUS (ON, OFF). 
RELEASE DATE (YYMMDD) 
OWNERSHIP TYPE (CENTER, USER). 



Figure 3-8. Example of File Level Left Screen K Display (Screen 1 of 3) 
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*TFSP* - TAPE FILE SUPERVISOR. 



SEPARAT=, 
COLON = 
READ 



USER 
FVSN 
ON 
FILE 



FI 



= TOSBAB 
= BB0005 
= 0001 
= FILE1 



=FILE1 



PW 


= 


CT 


=PRIVATE 


M 


=READ 


AC 


=NO 


ACCOUNT=00000000 


CDATE 


=840517 


CTIME 


=111409 


ADATE 


=840517 


ATIME 


=111409 


MDATE 


=840517 


MTIME 


=111409 



SEPARATOR CHARACTER (0-1 CHARACTERS). 
COLON CHARACTER (0-1 CHARACTERS). 
ALTERNATE INPUT FILE. 



PAGE 2 OF 3 

FILE CURRENTLY IS RESERVED. 

LOGICAL FILE IDENTIFIER. 
(1-17 CHARACTERS) 
PASSWORD, (0-7 CHARACTERS). 
ACCESS CATEGORY. 
(PRIVAGE, SPRIV, PUBLIC) 
ACCESS MODE (READ, WRITE, NULL). 
ALTERNATE CATLIST (NO, YES). 
ACCESS COUNT (0-16777215). 
CREATION DATE (YYMMDD). 
CREATION TIME (HHMMSS). 
LAST ACCESS DATE (YYMMDD). 
LAST ACCESS TIME (HHMMSS). 
LAST MODIFICATION DATE (YYMMDD). 
LAST MODIFICATION TIME (HHMMSS). 



Figure 3-9. Example of File Level Left Screen K Display (Screen 2 of 3) 
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SEPARAT= 


> 


COLON 


= 




READ 


= 




USER 


= 


TOSBAB 


FVSN 


= 


BB0005 


QN 


= 


0001 


FILE 


= 


FILE1 



PI 



=FILE1 



CR 


=84138 


CV 


=AS 





=PE 


E 


=00 


F 


=T 


FA 


= 


FC 


=5120 


G 


=0001 


LB 


=KL 


NS 


=00 


RT 


=84138 


SI 




SN 


=0001 



•TFSP* - TAPE FILE SUPERVISOR. 

SEPARATOR CHARACTER (0-1 CHARACTERS). 
COLON CHARACTER (0-1 CHARACTERS) . 
ALTERNATE INPUT FILE. 



PAGE 3 OF 3 

FILE CURRENTLY IS RESERVED. 

PHYSICAL FILE IDENTIFIER. 
(1-17 CHARACTERS) 
CREATION DATE (YYMMDD). 
CONVERSION MODE (AS, EB) . 
DENSITY (PE, GE, HI, HY, HD, CE, AE). 
GENERATION VERSION NUMBER (0-99) . 
FORMAT (I, S, L, SI, F, LI). 
ACCESSIBILITY (0-1 CHARACTERS). 
F-FORMAT MAX BLOCK SIZE (1-5120). 
GENERATION NUMBER (1-9999). 
LABEL TYPE (KL, KU, NS) . 
NOISE SIZE (0-31). 
RETENTION DATE (YYDDD). 
SET IDENTIFIER (0-6 CHARACTERS). 
SECTION NUMBER ( 1-9999) . 



i 



Figure 3-10. Example of File Level Left Screen K Display (Screen 3 of 3) 



•TFSP* FILE LEVEL *HELP* DISPLAY. 



HELP 
DISPLAY 
SEPARAT = CHAR 

COLON = CHAR 

READ = FILENAM 

REWIND = FILENAM 

BRIEF/NOBRIEF 

STOP 

AUDITAU = USERNAM 

AVSN = VSN 

AUSER = USERNAM 

RESERVE 

AMEND 

DROP 

GO 



DISPLAY LEGAL DIRECTIVES. 
TOGGLE OUT OF *HELP* DISPLAY. 
SET SEPARATOR CHARACTER. 
DEFAULT IS COMMA. 

SET COLON CHARACTER. DEFAULT IS NONE. 
READ DIRECTIVES OFF OF LOCAL FILE. 
REWIND LOCAL FILE. 
ENABLE/DISABLE INFORMATIVE OUTPUT. 
TERMINATE TFSP. 
AUDIT ALTERNATE USER. 
ASSIGN VSN TO TAPE FILE. 
BEGIN ALTERNATE USER LEVEL DIRECTIVES. 
PROCESS RESERVE OF TAPE FILE. 
PROCESS AMEND OF TAPE FILE. 
IGNORE RESERVE/AMEND OF TAPE FILE. 
RESERVE OR AMEND TAPE FILE. 



Figure 3-11. Example of File Level Right Screen K Display 
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•TFSP* 



TAPE FILE SUPERVISOR. 



SEPARAT=, 
COLON = 
READ = 
USER = TOSBAB 
FILE = FILE1 
AUSER = TOSJDH 



AMODE = IMPLICIT 

AACOUNT=000000 
AADATE =840723 
AATIME =172617 



SEPARATOR CHARACTER (0-1 CHARACTERS), 
COLON CHARACTER (0-1 CHARACTERS). 
ALTERNATE INPUT FILE. 



USER CURRENTLY IS ADMITTED. 

PERMISSION MODE. 

(IMPLICIT, WRITE, READ, NULL, SPECIAL) 

ACCESS COUNT. (0-262143) 

LAST ACCESS DATE. (YYMMDD) 

LAST ACCESS TIME. (HHMMSS) 



Figure 3-12. Example of Alternate User Level Left Screen K Display 



*TFSP* ALT 


USER 


LEVEL *HELP* DISPLAY. 


HELP 




DISPLAY LEGAL DIRECTIVES. 


DISPLAY 




TOGGLE OUT OF "HELP* DISPLAY. 


SEPARAT = CHAR 




SET SEPARATOR CHARACTER. 
DEFAULT IS COMMA. 


COLON = CHAR 




SET COLON CHARACTER. DEFAULT IS NONE. 


READ = FILENAM 


READ DIRECTIVES OFF OF LOCAL FILE. 


REWIND = FILENAM 


REWIND LOCAL FILE. 


BRIEF/NOBRIEF 




ENABLE/DISABLE INFORMATIVE OUTPUT. 


STOP 




TERMINATE TFSP. 


ADMIT 




PROCESS ALTERNATE USER ADMIT. 


DROP 




IGNORE ALTERNATE USER ADMIT. 


GO 




PROCESS ALTERNATE USER ADMIT. 



Figure 3-13. Example of Alternate User Level Right Screen K Display 
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Common Keyword Value Descriptions 

The following keyword values apply to the various levels of TFSP directives. 
Value Description 



chargno 

family 

fileident 

hhmmss 

passwor 
projectno 

pvsn 
setid 
usernam 
vsn 



vsn/seqno 

yyddd 
yymmdd 



1 to 10 characters. Alphanumeric characters or an asterisk may be 
used. 

1 to 7 alphanumeric characters. 

1 to 17 alphanumeric characters. 

Hour, minutes, and seconds. For example: 133024 is 30 minu tes 24 
seconds past 1 p.m. 

to 7 alphanumeric characters. 

1 to 20 characters. Alphanumeric characters or an asterisk may be 
used. 

1 to 6 characters. Blanks are significant. 

to 6 characters. Blanks are significant. 

1 to 7 alphanumeric characters. 

The VSN may be 1 to 6 characters on input. However, TFSP pads 
the vsn to six characters by inserting zeros before the first numeric 
character. Blanks are ignored. For example: 

Tl becomes T00001 

T1A becomes T0001A 

TA becomes TA0000 

The vsn is specified as above. Valid values for seqno are 1 through 
9999. A slant (/) separates the vsn and the seqno. If vsn is 
specified alone, seqno defaults to 1. 

Year and day (Julian format). For example: 85105 is April 15, 
1985. 

Year, month, and day. For example: 850415 is April 15, 1985. 



Ill 

II 

m 

■ 4 

ill 

II 

* 

mm 
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Family Level Directives 

Family level directives reference all tape file entries and VSNs in the tape catalog file. 

Directive Description 

AUDITCH=chargno 



AUDITUN = usernam 



AUDITVS=vsn 



BRIEF 



CATERR= status 



COLON = char 



DISPLAY 



DROP 



FAMNAME=family 



Copies information about file entries belonging to the specified 
charge number to the output file. A null chargno is invalid. 

Copies information about the tape file entries for user name 
usernam to the output file. If usernam is null, all tape file 
entries in the tape catalog file are processed. 

Copies information about VSN vsn to the output file. The 
information includes whether the VSN is included in the tape 
catalog file and its position in a multivolume tape file. If vsn 
is null, every VSN in the tape catalog file is processed. 

Disables the printing of informative messages on the output 
file. Information messages affected include messages prefixed 
by the flag INFORM, images of valid input directives, and the 
first eight lines issued as a result of a DISPLAY directive. 

Sets the error status of the tape catalog file. Valid entries for 
status are: 

CLEAR 

Clears error status and message buffer. 

SET 

Sets error status and sets TFSP error message in message 
buffer. 

Default is CLEAR. 

A nonblank, nonalphanumeric character that is interpreted as 
a colon in the directive stream. Default is no character. 

Toggles from the HELP display to the normal left screen 
display for the OP=K option. The display is copied to the 
output file if the OP =K option has not been specified. 

Terminates TFSP. Changes specified by the family level 
directives are ignored. 

Sets the family name of the tape catalog file. If family is null, 
the family name of the job is used. 
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Directive 



Description 



FOREIGN = status 



GLOBAL = status 



GO 
HELP 

IN VALID = usernam 
ISV 



MID=id 

MRE ADCH = chargno 

MREADUN = usernam 



Specifies if the scratch tapes of this family are foreign to the 
running system. Valid entries for status are: 

NO 

Family is not foreign to system. 

YES 

Fa mi ly is foreign to system. 

Default is NO. 

Specifies if the scratch tapes of this family are available to 
other families. Valid entries for status are: 

NO 

Scratch tapes are unavailable to other families. 

YES 

Scratch tapes are available to other families. 

Default is NO. 

Makes updates entered by family level directives, then 
terminates TFSP. 

Displays a list of valid directives. HELP is also available on 
the right screen of the K- display for the OP=K option. The 
display is copied to the output file if the OP=K option has 
not been specified. 

Removes usernam as a user validated by the VALIDAT 
directive. A null usernam is invalid. 

Initializes scratch VSNs. Entering this directive ensures that 
all VSNs that are not assigned to tape files are available as 
scratch VSNs. This directive should be issued to add VSNs to 
the scratch VSN list after they have been added to the tape 
catalog file with the VSN directive. 

Sets the machine identifier of the tape catalog file. If id is 
null, the machine identifier of the running system is used. 

Copies information about tape file entries belonging to the 
specified charge number to a machine-readable file. A null 
chargno is invalid. 

Copies information about tape file entries for user name 
usernam to a machine-readable file. If usernam is null, all 
tape file entries in the tape catalog file are processed. 
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Directive 



Description 



MREADVS=vsn 

NOBRIEF 
PURGALL = usernam 

PURGE =vsn 

READ=filenam 



RELEASE =vsn 



REMOVE =vsn 



REWIND =filenam 



SEPARAT=char 



Copies information about VSN vsn to a machine-readable file. 
The information includes whether the VSN is included in the 
tape catalog file and its position in a multivolume tape file. If 
vsn is null, every VSN in the tape catalog file is processed. 

Enables the printing of informative messages disabled by 
BRIEF. TFSP is initially in NOBRIEF mode. 

Purges all tape file entries that belong to usernam from the 
tape catalog file. Releases all VSNs that were assigned to the 
tape file entries of usernam. The released VSNs are removed 
from the tape catalog file. A null usernam is invalid. 

Releases and removes the specified tape file from the tape file 
catalog. Every VSN associated with that tape file is purged. If 
the VSN is not assigned, it is removed from the tape catalog 
file. A null vsn is invalid. 

Reads TFSP directives from local file filenam until an 
end-of-record, end-of-file, or end-of-information is reached. 
TFSP processes the directives until an error is encountered or 
the end of the directives is reached. The READ directive 
cannot be included in the file that is read. The file is not 
rewound before or after it is read. A null filenam is invalid. 

Purges the tape file entries that have an assigned VSN of vsn 
from the tape catalog file. Every VSN associated with that 
tape file is released. A null vsn is invalid. 

Removes VSN vsn from the tape catalog file. Once removed, 
vsn cannot be assigned to a tape file entry until a VSN 
directive has been issued. The vsn specified by the REMOVE 
directive cannot be assigned to a tape file entry. An assigned 
VSN would have to be released from its tape file entry first 
by the RELEASE, RELEASF, or RELEASV directive. A null 
vsn is invalid. 

Rewinds the local filenam. This directive is usually used with 
the SOURCE, AUDIT, and READ directives. A null filenam is 
invalid. 

A nonblank, nonalphanumeric character that is interpreted as 
a separator, even by the PRN, FI, PI, UC, and SI directives. 
Default is a comma. 
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Directive 



Description 



SOURCCH=chargno 

SOURCE 
SOURCUN = usernam 

SOURCVS=vsn 

STOP 

USER = usernam 

VALIDAT = usernam 
VSN=vsn 



Copies the directives required to create the tape file entries 
belonging to the specified charge number to the source file. A 
null chargno is invalid. 

Copies the directives required to recreate the tape catalog file 
to the source file. 

Copies the directives required to create the tape file entries 
for user name usernam to the source file. If usernam is null, 
all tape file entries in the tape catalog file are processed. 

Copies the directives required to add VSN vsn as a scratch 
tape to the source file. If vsn is null, every VSN in the tape 
catalog file is processed. 

Terminate TFSP. Changes specified by the family level 
directive are ignored. 

Begins user level directives. All directives following the USER 
directive and before the next user level DROP or END 
directive are associated with tape file entries belonging to user 
name usernam. A null usernam is invalid. 

Adds usernam as a user that is validated to use TFSP to 
access and update the family tape catalog file from a 
nonsystem origin job. Up to eight user names can be added. A 
null usernam is invalid. 

Begins VSN level directives and implicitly selects a tape 
device of MT (7-track) or NT (9-track). All directives following 
the VSN directive and before the next ADD, REVISE, END, 
or DROP directive are associated with VSN vsn. The VSN is 
added to the tape catalog file if it is not already there. A null 
vsn is invalid. 
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VSN Level Directives 

VSN level directives reference one VSN. VSN level directives may occur anywhere 
after a VSN directive and before an ADD, REVISE, GO, or DROP directive. 



Directive 



Description 



ADD 

DROP 
ERRFLAG=flag 



GO 

MAINT=main 



End processing of VSN level directives. The specified VSN is 
added to the tape catalog. Invalid if the VSN is already in the 
tape catalog. 

End processing of VSN level directives. Changes specified by 
the VSN level directives are ignored. 

Sets or clears the read/write error flag for the VSN. Valid 
entries for flag are: 

SET 

Set error flag. 

CLEAR 

Clear error flag. 

Default is CLEAR. 

Same as ADD for a new VSN. Same as REVISE for an 
existing VSN. 

Sets the maintenance status for the VSN. A VSN held for 
maintenance cannot be assigned to a tape file entry. Valid 
entries for main are: 

HOLD 

Hold for maintenance. 

AVAILABLE 

Available for assignment. 

Default is AVAILABLE. 
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Directive 



Description 



OWNER=type 



PRN=pvsn 
REVISE 

SITE = site 



SYSTEM =sys 



Sets the ownership status of the VSN. OWNER = USER may 
not be specified for a VSN with the system VSN flag set. 
Valid entries for type are: 

CENTER 
Center-owned. 

USER 
User-owned. 

Default is CENTER. 

Sets the physical (internal) VSN. Default is the logical 
(external) VSN. 

End processing of VSN level directives. The changes specified 
by the VSN level directives are made to the specified VSN. 
Invalid if the VSN is not in the tape catalog. 

Sets the off-site/on-site status of the VSN. Users cannot access 
an off-site VSN. Valid entries for site are: 

ON 

On-site. 

OFF 
Off-site. 

Default is ON. 

Sets the system VSN flag status of the VSN. A VSN with the 
system VSN flag set cannot be used as a scratch VSN but can 
be assigned to a tape file by TFSP. This directive is valid 
only when a VSN is first created; it cannot be specified for a 
user- owned VSN. Valid entries for sys are: 

YES 

The VSN is a system VSN. 

NO 

The VSN is not a system VSN. 

Default is NO. 
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VT=type Sets the tape type of the VSN. This directive is valid only 

when a VSN is first created. Valid entries for type are: 

MTNT 

VSN can be used as either a 7-track (MT) or a 9-track 
(NT) tape. 

CT 

VSN can be used only as a cartridge (CT) tape. 

AT 

VSN can be used only as a cartridge (AT) tape. 

Default is MTNT. 
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User Level Directives 

User level directives reference the tape file entries belonging to one user on the tape 
catalog file. User level directives may occur anywhere after a USER directive. 



Directive 



Description 



AUDITCN=chargno 

AUDITFI=fileident 
AUDITFV=vsn 

DROP 

FILE=fileident 



FILE V = vsn/seqno 



GO 

MRE ADCN = chargno 



Copies information about the tape file entries belonging to the 
user with a charge number of chargno to the output file. A 
null chargno is invalid. 

Copies information about the tape file entry fileident to the 
output file. A null fileident is invalid. 

Copies information about the tape file entries belonging to the 
user with an assigned VSN of vsn to the output file. A null 
vsn is invalid. 

Ends processing of user level directives. Changes specified by 
the user level directives are ignored. 

Begins file level directives. All directives following the FILE 
directive and before the next AMEND, RESERVE, or file level 
DROP or END directive are associated with the tape file entry 
fileident belonging to the user. FILE can be used to create a 
new or update an existing symbolic access tape file entry. 
Nonsymbolic access tape files must be referenced by the 
FILEV directive. A null fileident is invalid. 

Begins file level directives. All directives following the FILEV 
directive and before the next AMEND, RESERVE, or file level 
END or DROP directive are associated with the tape file entry 
belonging to the user with an assigned VSN of vsn and 
sequence number seqno. The file position in a multifile set is 
specified by seqno. FILEV can be used to create a new or 
update an existing tape file entry. A null vsn is invalid. If 
seqno is omitted, a value of 1 is assumed. 

Same as DROP. 

Copies information about the tape file entries belonging to the 
user with a charge number of chargno to the machine-readable 
file. A null chargno is invalid. 
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Directive 



Description 



MREADFI = fileident 



MREADFV = vsn 



RELEASF = fileident 



RELEASV = vsn 



SOURCCN = chargno 



SOURCFI=fileident 



SOURCFV = vsn 



Copies information about the tape file entry fileident to the 
machine-readable file. A null fileident is invalid. 

Copies information about the tape file entries belonging to the 
user with an assigned VSN of vsn to the machine-readable 
file. A null vsn is invalid. 

Purges the tape file entry fileident belonging to the user from 
the tape catalog file. Every VSN associated with that tape file 
entry is released. A null fileident is invalid. 

Purges the tape file entries belonging to the user with an 
assigned VSN of vsn from the tape catalog file. Every VSN 
associated with that tape file is released. A null vsn is 
invalid. 

Copies the directives required to create the tape file entries 
belonging to the user with a charge number of chargno to the 
source file. A null chargno is invalid. 

Copies the directives required to create the tape file entry 
fileident belonging to the user to the source file. A null 
fileident is invalid. 

Copies the directive required to create the tape file entries 
belonging to the user with an assigned VSN of vsn to the 
source file. A null vsn is invaid. 

When a plus character is in column 1 of the input line, the 
list of tape file entries displayed on the left-screen K display 
is toggled. Except for the OP = K option, the DISPLAY 
directive must be issued to copy the display to the output file. 
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File Level Directives 

File level directives reference one tape file entry belonging to the user. File level 
directives may occur anywhere after a FILE or FILEV directive. Whenever a file level 
directive is assigned a null value, TFSP sets the default value unless stated otherwise 
in the directive description. Site personnel will probably find that they only have to 
enter a few of the file level directives (such as CN and AVSN) when creating new tape 
file entries. Most of the file level directives exist for the dumping and loading of tape 
file entries using the source file. 



Directive 



AC = op 



ACOUNT= count 
ADATE = yymmdd 
AMEND 

ATIME = hhmmss 
AUDITAU = usernam 

AUSER = usernam 



Description 



Sets the CATLIST permission for alternate users of the tape 
file. Valid entries for op are: 

YES 

Alternate users can AUDIT the public or semiprivate tape 

file. 

NO 

Alternate users cannot AUDIT the tape file. 

Default is NO. Alternate users cannot AUDIT private tape 
files even if AC = YES. 

Sets the number of accesses of the tape file entry. Default is 
zero. 

Sets the date of last access of the tape file entry. Default is 
the current date. 

Ends processing of file level directives. The changes specified 
by the file level directives are made to the tape file. Invalid if 
the tape file is not reserved. 

Sets the time of last access of the tape file entry. Default is 
the current time. 

Copies the ADMIT information granted to user name usernam 
for the tape file entry to the output file. If usernam is null, 
all user names admitted to the tape file entry are processed. 

Begins alternate user level directives. All directives following 
the AUSER directive and before the next ADMIT, DROP, or 
END directive are associated with the permission granted to 
user name usernam for the tape file entry. Invalid entry if the 
tape file has not yet been reserved. A null usernam is invalid. 
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Directive 



Description 



AVSN=vsn 



CDATE=yymmdd 
CE=flag 



CN=chargno 
CR=yyddd 

CT=cat 



Adds vsn as the last VSN assigned to the tape file entry. This 
directive is invalid if the tape file entry already has 60 
assigned VSNs or if the tape file entry is not the last file in 
a multifile set. The VSN can be assigned if one of these 
conditions is met: 

1. The VSN is not assigned to another tape file, and its 
status and tape type matches the status and tape type of 
the first assigned VSN of the tape file. (See the 
ERRFLAG, MAINT, SITE, OWNER, TSITE, TOWNER, and 
VT directives for descriptions of the statuses and tape 
types.) 

2. The tape file entry has no assigned VSNs; the vsn is the 
last VSN of another tape file belonging to the user, and 
the tape type of the vsn is consistent with the density of 
the tape file entry. 

A null vsn is invalid. 

Sets the date of creation of the tape file entry. Default is the 
current date. 

Sets or clears the read/write error flag for the tape file entry. 
Valid entries for flag are: 

SET 

Set error flag. 

CLEAR 

Clear error flag. 

Default is CLEAR. 

Sets the charge number assigned to the tape file entry. 
Default is no charge number. 

Sets the creation date (Julian format) of an ANSI-labeled tape. 
This value is usually equivalent to the date specified by the 
CDATE directive; however, it can be different. Default is the 
current date. 

Sets the permit category for alternate users of the tape file. 
Valid entries for cat are: 

PRIVATE 

Private. Alternate user access restricted. 

SPRIV 

Semiprivate. Alternate user access allowed and recorded. 

PUBLIC 

Public. Alternate user access allowed but not recorded. 

Default is PRIVATE. 
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Directive Description 



CTIME=hhmmss Sets the time of creation of the tape file entry. Default is the 

current time. 

CV=mode Sets the conversion mode for the 9-track tape file entry. Valid 

entries for mode are: 

AS 

ASCII-display code conversion. 

EB 

EBCDIC-display code conversion. 

Default is AS. 

| D= density Sets the tape density. Also sets the tape type. A change in 

| density may not be made if it implies a change in tape type 

| and the file already has assigned VSNs. Valid entries for 

density are: 

I AE 

I 

I Cartridge tape for ACS (AT), 38000 cpi. 

| CE 

I Cartridge tape for CTS (CT), 38000 cpi. 

I HI 

| 7-track (MT), 556 cpi. 

I HY 

1 7-track (MT), 800 cpi. 

I 

1 HD 

1 9-track (NT), 800 cpi. 

% 

s 

I PE 

| 9-track (NT), 1600 cpi. 

| GE 

| 9-track (NT), 6250 cpi. 

Default is PE. 

DROP Ends processing of file level directives. Changes specified by 

the file level directives are ignored. 

E= number Sets the 1- or 2- digit generation version number for an 

ANSI-labeled tape. Default is 00. 
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Directive 



Description 



F= format 



FA=char 



FC= frames 



FI= fileident 



G= number 
GO 



Sets the data format of the tape file entry. Valid entries for 
format are: 

I 
Internal. 

S 
Stranger. 

L 

Long block stranger. 

LI 

Long block internal. 

SI 

SCOPE internal. 

F 
Foreign. 

Default is I. 

Sets the accessibility restriction for an ANSI-labeled tape. 
Valid entries for char are: 

null 

No accessibility restrictions for alternate users. 

A 

No accessibility allowed for alternate users. 

other (any alphanumeric character) 

Alternate users must specify char to access tape file entry. 

Default is null. 

Sets the maximum sized block that can be read from or 
written to an F format tape. The value must be greater than 
that specified by the NS directive. Default is unlimited. 

Changes the logical file identifier of the tape file entry to 
fileident. This is the n a m e specified by user commands and 
the FILE directive when accessing this tape file entry. The 
fileident must not be the name of any other tape file entry 
belonging to the user if symbolic access is set. Default is the 
same name as specified in the previous FILE directive. 

Sets the 1- to 4-digit generation number for an ANSI-labeled 
tape. Default is 0001. 

Same as RESERVE for a new tape file entry. Same as 
AMEND for an existing tape file entry. 
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Directive 



Description 



LB = label 



M=mode 



MDATE=yymmdd 
MTIME=hhmmss 
NS= frames 

PI=fileident 



PN=projectno 
PW=passwor 



Sets the label status of the tape file entry. Valid entries for 
label are: 

KU 

Unlabeled. 

KL 
ANSI-labeled. 

NS 

Nonstandard labeled. 

Default is KL. 

Sets the access mode for alternate users. Valid entries for 
mode are: 

READ 

Alternate users may only read the tape file. 

WRITE 

Alternate users may read or write the tape file. 

NULL 

Alternate users may not access the tape file. 

Default is READ. 

Sets the date of the last modification of the tape file entry. 
Default is the current date. 

Sets the time of last modification of the tape file entry. 
Default is the current time. 

Sets the minimum size of a valid block. Any smaller block is 
considered noise. Valid entries for frames are through 31, 
and must be less than frames specified by the FC directive. 
Default is 0. 

Sets the physical file identifier of the tape file entry. 
Generally, fileident is the same as the logical file identifier 
when the tape file entry is created. Default is the same name 
as specified in the FILE directive when the tape file entry is 
first created. If LB=KU when the tape file is reserved or 
amended, the physical file identifier is cleared. 

Sets the project number assigned to the tape file entry. 
Default is no project number. 

Sets the password that alternate users must specify to access 
the tape file. Default is no password. 
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Directive 



Description 



RDATE = yymmdd 



RECOVER = status- 



RESERVE 

RT = yyddd 

SI = setid 
SN = secno 
S V = access 



Sets the user release date of the tape file entry. If the 
directive is specified with no date (RDATE = ), the user release 
date is cleared. A user cannot access a tape file that has a 
user release date. Symbolic access should be cleared (SV = NO) 
whenever the release date is set to prevent file name conflicts 
for the user. (For multifile tape sets, symbolic access should 
be cleared for each tape file in the set if the release date is 
set.) 

This directive sets the same field as the URDATE directive. 
The URDATE directive sets the unconditional release date. 
The unconditional release date is the user release date plus 
the conditional release delay period. See the description of the 
conditional release delay period in section 5. 

Sets the recovery status of the tape file. Valid entries for 
status are: 

NO 

Tape file has not been recovered. 

YES 

Tape file has been recovered. The user may have to amend 

the tape file entry to return it to its original state. 

Default is NO. 

Ends processing of file level directives. The tape file is 
reserved. Invalid if the tape file already is reserved. 

Sets the retention date (Julian format) for an ANSI-labeled 
tape. No one (including the tape owner) can write over the 
tape before this date. Default is the current date. 

Sets the set identifier of an ANSI-labeled tape. Default is no 
set identifier. 

Sets the 1- to 4-digit file section number for an ANSI-labeled 
tape. Default is 0001. 

Sets the symbolic access status of the tape file. Valid entries 
for access are: 

NO 

No symbolic access. Tape file entry cannot be accessed by 

the file identifier. 

SET 

Symbolic access. Tape file entry can be accessed by the file 

identifier. 

Default is NO. 
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Directive 



Description 



TOWNER = type 



Sets the ownership status of all the VSNs assigned to the tape 
file entry. Valid entries for type are: 

CENTER 
Center-owned. 

USER 
User-owned. 



TSITE = site 



UC = word 



URDATE = yymmdd 



+ 



Default is CENTER. 

Sets the off-site/on-site status of all the VSNs assigned to the 
tape file entry. Users cannot access off-site tape files. Valid 
entries for site are: 

ON 
On-site. 

OFF 

Off-site. 

Default is ON. 

Sets the 10-character user control word for the tape file entry. 
Blanks are significant. TFSP will left justify and blank fill if 
word is less than 10 characters. Default is 10 colons. 

Sets the unconditional release date of the tape file entry. If 
the directive is specified with no date (URDATE = ), the 
unconditional release date is cleared. A user cannot access a 
tape file that has an unconditional release date. Symbolic 
access should be cleared (SV = NO) whenever the release date 
is set to prevent file name conflicts for the user. (For multifile 
tape sets, symbolic access should be cleared for each tape file 
in the set if the release date is set.) 

This directive sets the same field as the RDATE directive. The 
RDATE directive sets the user release date. The user release 
date is the unconditional release date minus the conditional 
release delay period. See the description of the conditional 
release delay period in section 5. 

When a plus character is in column 1 of the input line, the 
page displayed at the left-screen K display is toggled. Except 
for the OP = K option, the DISPLAY directive must be issued 
to copy the display to the output file. 
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Alternate User Level Directives 

Alternate user level directives reference an alternate user granted explicit permission 
to access the tape file. Alternate user level directives may occur anywhere after an 
AUSER directive and before an ADMIT, DROP, or GO directive. Whenever an alternate 
user level directive is assigned a null value, TFSP sets the default value. 



Directive 



Description 



AACOUNT= count Sets the number of accesses by the user. Default is zero. 

AADATE=yymmdd Sets the date of last access by the user. Default is the current 

date. 



AATIME = hhmmss 



ADMIT 



AMODE = mode 



DROP 



GO 



Sets the time of last access by the user. Default is the current 
time. 

End processing of alternate user level directives. The changes 
specified by the alternate user level directives are made to the 
alternate user. 

Sets the access mode granted to the user. Valid entries for mode 
are: 

NULL 

No access allowed to the user. 

READ 

User allowed to read but not write the tape file. 

WRITE 

User allowed to read and write the tape file. 

IMPLICIT 

Semiprivate access. The mode specified by the file level 
directive (M = mode) takes precedence. 

SPECIAL 

TMS conversion mode. 

Default is IMPLICIT. 

End processing of alternate user level directives. Changes 
specified by the alternate user level directives are ignored. 

Same as ADMIT. 
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TFSP Audit Directive Output Formats 

The TFSP audit directives have six output formats. Figures 3-14, 3-15, and 3-16 
illustrate these directives. 



Directive 



Description of Output 



AUDITAU 

AUDITCN 

AUDITFI 

AUDITFV 

AUDITUN 

AUDITVS 



Figure 3-14 is an example of the AUDITAU directive output 
format. 

Similar to the output format for the AUDITUN directive. 

Same as AUDITUN. Only one tape file entry is processed. 

Similar to the output format for the AUDITFI directive. 

Figure 3-15 is an example of the AUDITUN directive output 
format. User names are processed alphabetically. 

TFSP lists whether the VSN specified is in the tape catalog file 
or is assigned to a tape file entry. If it is assigned, TFSP will 
list the user name and file name of the tape file entry, the next 
VSN, and the first VSN of the entry. VSNs are sorted 
alphabetically. Figure 3-16 is an example of the AUDITVS 
directive output format. 



AUDIT LISTING. 










I 
I 


USER = USER3 




: ILE = 


= TAPEFILEID10 






FVSN = V00002 


QN = 


= 0001 








USER NAME 


MODE 






ACCESSES 


DATE 


TIME ! 


HTH345 


IMPLI 






000002 


830216 


071632 


USER002 


IMPLI 






000001 


830130 


225411 


USR0001 


READ 






000000 


830216 


155045 


USR0002 


NULL 






000000 


830216 


155045 



Figure 3-14. Example of AUDITAU = Directive Output 
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AUDIT LISTING. 

USER FILE-IDENTIFIER SV FVSN QN 

PASSWORD PHYSICAL-FILE-ID MD CT AC UCW 

CR CV D E F FA FC G LB NS RT 

ACCESSES CDATE CTIME ADATE ATIME MDATE MTIME 



CE CHARGE PROJECT-NUMBER 
SN SI 



USER0O2 N S00001 OOOI S CHARGNO 

R PR N 
83047 AS PE 00 I 5120 0001 KL 00 83047 
00000000 830216 155045 830216 155045 830216 155045 



0001 



S00001 



S00002 



S V00002 0001 c xxxxxxx 
R SP N 

5120 0001 KL 00 83047 



0001 



S V00002 0002 C XXXXXXX 
R PU Y 

5120 0001 KL 18 83047 0001 



USER3 TAPEFILEID10 
PASSWOR TAPEFILEID10 
83047 AS PE 00 I 

V00002 V00003 

USER3 TAPEFILEID11 
TAPEFILEID11 
83047 AS PE 00 I 
00000000 830216 155045 830216 155045 830216 155045 

V00003 

USER3 N USER3T 0001 C 9999999 

XXXXXBBBBB R PR N 
83047 AS PE 00 I 5120 0001 KL 00 83047 0001 
00000000 830216 155045 830216 155045 830216 155045 

USER3T 

TAPEUSE N B00001 0001 C TAPECHG TAPEPROJECT 

R PR N :::::::::: 
84075 AS PE 00 I 5120 0001 KL 00 84075 0001 : 
00000000 840315 085305 840315 085305 840315 085305 
•* TO BE RELEASED 840323 " 



B00001 
TAPEUSE 



B00002 



N B00001 0002 C TAPECHG TAPEPROJECT 

R PR N :::::::::: 
84075 AS PE 00 I 5120 0001 KL 00 84075 0002 
00000000 840315 085305 840315 085305 840315 085305 
** TO BE RELEASED 850323 ** 

B00002 



Figure 3-15. Example of AUDITUN= Directive Output 
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AUDIT LISTING. 
















VSN PRN VT 


STATUS UC OWNER 


SITE 


SYSTEM CHARGE 


URDATE 


FVSN 


NVSN 


A00001 A00001 MTNT 


AVAIL 00 CENTER 


ON 


NO 


•NOT ASSIGNED* 








A00002 A00002 MTNT 


AVAIL 05 CENTER 


ON 


NO 


USER001 CHRG001 


840315 


A00002 


A00003 


A00003 A00003 CT 


AVAIL 03 CENTER 


ON 


YES 


USER001 CHRG001 


840315 


A00002 




U00007 MYTAPE AT 


AVAIL 15 USER 


ON 


NO 


USER005 MYCHRGE 




U00007 





Figure 3-16. Example of AUDIT VS= Directive Output 



TFSP Machine-Readable File Format 

The format of a machine-readable file generated by TFSP is similar in most fields to 
that generated by the AUDIT command. For the MREADVS directive, VSNs that are 
not assigned to a tape file can also be listed. In this case, characters 9 to 155 and 197 
to 215 of the machine-readable record are set to blanks. The format of the 
machine-readable record is as follows: 

Table 3-1. TFSP Logical Record Format (Machine-Readable File) 



1 Column 



Description 



01 Version; numeric 

02 - 08 Family name; alphanumeric 
09 - 15 User name; 1 alphanumeric 

16 - 22 Charge number; 1 alphanumeric 

23 - 42 Project number; 1 alphanumeric 

43 - 59 Tape logical file name or VSN if nonsymbolic 1 ; alphanumeric 

60 - 66 File category; 1 alphabetic (P, PR, PU, SP) 

67 - 72 Creation date (yymmdd); 1 numeric 

73 - 78 Creation time (hhmmss); 1 numeric 

79-84 Last access date (yymmdd); 1 numeric 

85-90 Last access time (hhmmss); 1 numeric 

91 - 96 Last modification date (yymmdd); 1 numeric 

97 - 102 Last modification time (hhmmss); 1 numeric 

103 - 108 File permission mode; 1 alphabetic (R, W, N) 



1. This field is filled with blanks for a VSN that is not assigned to a tape file. 



(Continued) 
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Table 3-1. TFSP Logical Record Format (Machine-Readable File) (Continued) 



Column 



Description 



109 - 118 Access count; 1 numeric 

119 - 120 File format; 1 alphabetic (I, SI, F, S, SL, LI) 

121 - 122 Conversion mode; 1 alphabetic (AS, EB) 

123 - 124 Physical tape type; 1 alphabetic (NT, MT, CT, AT) 

125 - 126 Tape density; 1 alphabetic (HI, LO, HY, HD, PE, GE, CE, AE) 

127 - 129 Not used (blanks) 

130 - 139 User control word (UW) 1 

140 - 143 Not used (blanks) 

144 Error indicator that specifies whether or not NOS detected an error in 
this file; alphabetic (S, C) 

145 Not used (blank) 

146 - 152 File password (blanks for alternate users); 1 alphanumeric 
153 - 155 Not used (blanks) 

156 - 161 VSN (external); alphanumeric 

162 - 167 PRN (internal); alphanumeric 

168 - 173 First VSN; alphanumeric 

174 - 179 Next VSN (blank if no next volume); alphanumeric 

180 - 184 Maintenance flag; alphabetic 

HOLD if hold for maintenance 
AVAIL if available 

185 - 187 Site status; alphabetic 

ON if on-site 
OFF if off-site 

188 - 193 Ownership type; alphabetic 

CENTER if center-owned 
USER if user-owned 

194 Error indicator that specifies whether NOS detected an error on this 
VSN; alphabetic 



1. This field is filled with blanks for a VSN that is not assigned to a tape file. 

(Continued) 
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| Table 3-1. TFSP Logical Record Format (Machine-Readable Pile) (Continued) 
Column Description 



? 



195 - 196 Volume number; numeric 

197 - 198 Label status; 1 alphabetic (KL, KU, NS) 

| 199 - 215 Physical file name; 1 alphanumeric 

| 216 - 217 Tape usage count; numeric 

218 - 223 Release dates (yymmdd); numeric 

224 Reserved flag; alphabetic 



:i 



£ 



I: 



| R if reserved tape file 

1 N if tape file is not reserved 

| 

| 225 Recovery flag; alphabetic 

| 

| S if recovered tape file 

| N if not recovered tape file 

| 

1 226 New release date format flag; alphabetic 

| * if new format 

1 Blank if old format 
I 

1 227 - 229 System VSN flag; alphabetic 

I 

| YES if system VSN 

j NO if not system VSN 

| 230 - 233 VSN tape type; alphabetic 

| 

I MTNT if either MT or NT tape 

| CT if cartridge tape for CTS 

| AT if cartridge tape for ACS 

I _ 

| 1. This field is filled with blanks for a VSN that is not assigned to a tape file. 
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TFSP Aborts and Recovery 

TFSP aborts whenever one of the following conditions is present: 

• Command parameter error. 

• File name conflict. 

• Error in the tape catalog file. 

• User issuing the command is not validated. 

• Fast-attached file ZZZZZFC cannot be found. 

In abort mode, TFSP aborts on directive errors. When TFSP aborts, it issues the 

ABORT macro so the system can initiate EXIT processing. §||| 

When TFSP is aborted externally (such as an operator DROP or KILL), TFSP clears § 

its interlock on the fast-attached tape catalog file. However, it is possible that busy i 1 

interlocks on VSNs could be set, leaving the VSNs inaccessible. In this case, it may fHf 

become necessary to reinitialize the tape catalog file using the ISV directive. |j| 

If TFSP happens to be executing when the system or IAF crashes, the tape catalog file *™> 

or some VSNs could remain interlocked and therefore inaccessible. If the IAF job can 

be recovered, TFSP should be able to continue from the point of the abort. If the 

fast-attached tape catalog file is interlocked, it may be necessary to use the TFSPE 

command to clear the interlock. If VSNs are interlocked, it may be necessary to 

reinitialize the tape catalog file using the ISV directive. 
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TFSPE Command 

Site personnel can use the TFSPE command to clear interlocks in the tape catalog file 
that prevent normal TFSP jobs from accessing the tape catalog file. When TFSPE is 
executed, any other TFSP job that is accessing the tape catalog file of the same family 
is aborted. TFSPE can be used only from a system origin job. 

Format: 

TFSPE (FM=f ami 1y,L=f i lenam,S=f i lenam,SS=f i lenam,CF=f i lenam, CLEAR) 

The default for the FM parameter is the default family. The default for the L 
parameter is OUTPUT. The default for the S parameter is SOURCE. The default for 
the SS parameter is no file. 

TFSPE is equivalent to the TFSP(OP=K) command with the following three exceptions: 

1. The initial left screen K display includes the following information: 

TAPE CATALOG ERROR DISCOVERED AT - yy/nm/dd, hh.mm.ss. 
The error is explained in the message buffer. 

2. The interlock that prevents multiple TFSP jobs from accessing a tape catalog file is 
cleared and reset so that only the TFSPE job can access the file. Any other TFSP 
job attempting to access the tape catalog file is aborted. 

3. The following parameters are also available on the TFSPE command: 



Parameter 



Description 



CF=filename 



CLEAR 



Copy file for TFSPE. If this parameter is specified on the 
TFSPE command, TFSPE attempts to define a direct access file 
on user name SYSTEMX with the permanent file name filenam. 
TFSPE then copies the current tape catalog file to filenam. If 
this parameter is not specified, TFSPE does not copy the 
current tape catalog file. If CF is specified without a file name, 
ZFCCOPY is assumed. 

Clear information from tape catalog file for TFSPE. If this 
parameter is specified on the TFSPE command, TFSPE 
overwrites the tape catalog file as an empty tape catalog file. 
The foreign catalog and catalog error statuses are set. The 
CLEAR parameter can only be specified if there is a catalog 
error on the current tape catalog file and the CF parameter is 
also specified on the TFSPE command. 



3-40 NOS 2 Tape Management System (TMS) 



60463350 D 



TMSDIS 4 

TMSDIS Command 4-2 

TMSDIS Displays 4-3 

TMSDIS Help Display 4-3 

TMSDIS Tape Equipment Display 4-4 

TMSDIS Family Catalog Display 4-6 

TMSDIS Executing Job Display 4-7 

TMSDIS Preview Display 4-8 

TMSDIS Input Commands 4-11 



TMSDIS 4 

The tape display utility TMSDIS can be used as a replacement for the tape-related 
DSD displays and commands for a system that runs with the Tape Management System 
(TMS). TMSDIS can be used as an L-display utility from the system console or can be 
used from nonsystem origin jobs by validated users. To use TMSDIS from a nonsystem 
origin job, the user must be validated to use the tape file supervisor TFSP. 
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TMSDIS Command 

You call the TMSDIS utility with a command of that same name. The command has 
both an order-dependent and order-independent format. 

Order-dependent format: 

TMSDIS, 1d1s, mode, 1nf1 le.outf lie, time, NOBELL. 
Order-independent format: 

TMSDIS, ID=ld1s,0P«mode,I=1nf1le,L=outf lie, WT*time, NOBELL. 
Parameter Description 



idis 
mode 



Initial display. Valid entries for idis are HELP, PRE, EQU, FAM, 
and JOB. Default is HELP. 

Input/output option. Valid entries for mode are: 



infile 

outfile 
time 

NOBELL 



L display. Valid only from system origin. 

LINE 

Read commands from input file and write displays to output 
file. 

SCREEN 

Read commands from terminal input file and write displays to 
terminal output file. Displays are refreshed while waiting for 
input. Input can be entered after entering interruption sequence 
(user break 1). Valid only from interactive origin. 

Default is L for system origin and LINE for nonsystem origin. 

Input file name. Ignored for L-display and SCREEN modes. Default 
is INPUT. 

Output file name. Ignored for SCREEN mode. Default is OUTPUT. 

Waiting time in seconds before a display is refreshed. Ignored for 
LINE mode. A value greater than 4095 is converted to 4095. 
Default is 2 for L-display mode and 10 for SCREEN mode. 

Ignored for line and L-display modes. If NOBELL is not specified, a 
bell sounds at the terminal when the screen is refreshed and when 
there are preview display entries, family tape catalogs with errors, 
family tape catalogs with no scratch VSNs, or tape jobs requiring 
operator action. If NOBELL is specified, the bell does not sound. 
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TMSDIS Displays 

Each TMSDIS display includes a four-line header with MAGNET status, TMS status, 
the current display name, the current page number, the number of entries in the 
TMSDIS preview display, the number of tape jobs requiring action, the number of TMS 
tape catalogs with errors, and the number of TMS tape catalogs with no scratch tapes. 
Figure 4-1 is an example of the TMSDIS display headers. 



TMSDIS. MAG ACTIVE. TMS ENABLED. PRE DISPLAY PAGE 1 OF 2. 
PREVIEW ENTRIES= 3. JOBS REQUIRING ACTION= 1. 
CATALOGS WITH ERRORS= 0. CATALOGS WITH NO MT/NT SCRATCH= 2. 
CATALOGS WITH NO CT SCRATCH= 2. CATALOGS WITH NO AT SCRATCH= 2. 



Figure 4-1. TMSDIS Display Headers 

TMSDIS Help Display 

The TMSDIS help display lists the TMSDIS input commands. The TMSDIS help display 
(figures 4-2 and 4-3) is initiated by the HELP command. 



HELP 

PRE 

JOB 

FAM 

EQU 

COPY 

+N 

-N 

DROP 



DISPLAY VALID COMMANDS. 

DISPLAY RESOURCE REQUESTS. 

DISPLAY TAPE JOBS REQUIRING OPERATOR ACTION. 

DISPLAY *TMS* FAMILY TAPE CATALOG STATUSES. 

DISPLAY TAPE EQUIPMENT STATUSES. 

COPY CURRENT DISPLAY TO OUTPUT FILE. 

TOGGLE *N* PAGES FORWARD. 

TOGGLE *N* PAGES BACKWARD. 

TERMINATE *TMSDIS*. 



Figure 4-2. TMSDIS HELP Display (Screen 1 of 2) 



ASSIGN, JSN, EST 
GO, EST 
SCRATCH, EST 
STOP, EST 
UNLOAD, EST 
VSN.EST 
VSN.EST, 
VSN.EST.VSN 
+ 

DROP 



ASSIGN TAPE ON *EST* TO JOB *JSN*. 

AUTO BLANK LABEL TAPE ON *EST*. 

DECLARE TAPE ON *EST* AS SCRATCH. 

DO NOT AUTO BLANK LABEL TAPE ON *EST*. 

UNLOAD TAPE ON *EST*. 

CLEAR VSN ON «EST*. 

DECLARE TAPE ON *EST* AS SCRATCH. 

DECLARE TAPE ON *EST* TO HAVE VSN OF *VSN*. 

TOGGLE PAGE FORWARD. 

TOGGLE PAGE BACKWARD. 

TERMINATE *TMSDIS*. 



Figure 4-3. TMSDIS HELP Display (Screen 2 of 2) 
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TMSDIS Tape Equipment Display 

The TMSDIS tape equipment display lists the status of each tape equipment on the 
system. The TMSDIS tape equipment display is initiated by the EQU command. 
Figure 4-4 is an example of the TMSDIS tape equipment display. 



EST 


VSN 


DEN 


FlING 


FWT 


JSN 


STATUS 


REEL MD FILE-ID 


NT060 


SFTDMP 


6250 


IN 






IDLE 


0001 AS 


NT061 


*"061 


6250 


IN 






IDLE 


0001 UNLABELED. 


NT063 


SKDDMP 


38000 


IN 






IDLE 


0001 AS 


CT070 




OUT 








IDLE 




CT071 


CTS002 


38000 


IN 






IDLE 


0001 AS SUNDAYNOON 


AT 100 




38000 


IN 






IDLE 




AT101 


C00375 


38000 


IN 


I ABVS 


READY 


0001 AS TAPE 


CT110 




200 








DOWN 




CT111 




200 








DOWN 




CT112 




200 








DOWN 




CT113 




200 








DOWN 




AT120 




200 








DOWN 




AT121 




200 








DOWN 




AT 122 




200 








DOWN 





Figure 4-4 TMSDIS Tape Equipment Display 

Each entry on this display has the following format. 

est vsn den ring fmt jsn status reel md file-id 

est Identifies the track type and EST ordinal of the tape unit. The format 

MTest is used for 7-track tape, NTest is used for 9-track tape, CTest is 
used for cartridge tape for CTS, and ATest is used for cartridge tape for 
ACS. 

vsn The physical VSN of the mounted tape. This field contains ***est if the 

tape does not have a recognizable label. 

den Density in cpi. 

ring Write enable status. IN if write ring in for MT or NT tape or if write 

enable thumbwheel set correctly for AT or CT tape. Blank if not 
write-enabled. 

fmt Data format. F for foreign, I for internal, LI for long block internal, L for 

long block stranger, S for stranger, and SI for system internal. 

jsn Job sequence name of the job the tape unit is assigned to. 
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status Status of the tape unit: 

READY 

Job using unit is executing. 

IDLE 

Unit is not being used. 

LOADPT 

Tape is positioned at load point. 

ROLLED 

Job using unit is rolled out. 

DOWN 

Unit has been logically removed from the operating environment. 

NOTRDY 

Unit is not ready or rewinding. 

TFM 

Unit is not ready because of TMS activity. 

*PRE* 

Operator action is required on unit; check the TMSDIS preview display. 

reel Reel (volume) number currently in use or reel (volume) number of the next 

tape to be mounted. 

md Conversion mode of the mounted tape: 

blank 

No conversion. 

BC 

BCD (MT). 

AS 

ASCII (NT, CT, or AT). 

EB 

EBCDIC (NT, CT, or AT). 

file-id File identifier obtained from tape label. 
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TMSDIS Family Catalog Display 

The TMSDIS family catalog display lists the status of the TMS tape catalog file for 
each family on the system. Figure 4-5 is an example of the TMSDIS family catalog 
display. 



FAMILY MN/NT SCRATCH 

STATUS COUNT NXT-VSN 

SFT 

NO SCRATCH VSNS. 

SKD 70 TMSB01 

NVE 

CATALOG NOT FOUND. 

STST32 

CATALOG NOT FOUND. 



CT SCRATCH 
COUNT NXT-VSN 
o 


AT SCRATCH 
COUNT NXT-VSN 



7 CTS001 


11 C00900 





o 









Figure 4-5. TMSDIS Family Catalog Display 

Each entry on this display has the following format: 

family count nxt-vsn count nxt-vsn count nxt-vsn 

status 



family 



count 



I nxt-vsn 



i status 



Family name. An asterisk (*) after the family name indicates the tape 
catalog information processed by TMS is not up-to-date. 

Number of scratch VSNs (MT/NT, CT, or AT) in the tape catalog for 
this family. Count and next-vsn are grouped according to tape device 
type (MT/NT, CT, or AT). 

The next scratch VSN of this tape type in the tape catalog for this 

family. This field is six hyphens ( ) if either no scratch tapes are in 

the tape catalog or if the family does not have a fast-attached tape 
catalog. Count and next-vsn are grouped according to tape device type 
(MT/NT, CT, or AT). 

Status message for tape catalog. The status message appears on the 
second line of each entry on this display. If the tape catalog has an 
error condition, this field contains the contents of the catalog message 
buffer. 



Status Message 



Error Condition 



NO SCRATCH VSNS 



Scratch count is zero for all tape types. 



CATALOG NOT fast-attached Tape catalog exists but has not been 

fast-attached. 



CATALOG NOT FOUND 
CATALOG LINKAGE ERROR 



Tape catalog does not exist. 

The integrity of your database file is 
questionable. 
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The family catalogs are ordered in this display as follows: 

1. Families with catalog errors 

2. Families with no scratch VSNs 

3. Families with fast-attached catalogs but no errors 

4. Families without fast-attached catalogs 

5. Families without catalogs 

TMSDIS Executing Job Display 

The TMSDIS executing job display identifies jobs that have made tape requests that 
require operator action. Figure 4-6 is an example of the TMSDIS executing job display. 



JSN USERNAM FAMILY MESSAGE 

AXYZ USER 16 KTJ REQUEST - TAPE, GE, VSN001 

AGHT TSUSAAA TFFAMLY REQUEST, TAPE, D=PE,LB=KU 

AHID SYSTEMX KIB REQUEST - BLKTAPE, GE 



mm 



Figure 4-6. TMSDIS Executing Job Display 

Each entry on this display has the following format: 

m 

jsn usernam family message H| 

jsn Job sequence name, 

usernam User name of job. 
family Family name of job. 

message Message indicating operator action required. 
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TMSDIS Preview Display 

The TMSDIS preview display identifies tapes and packs required to satisfy resource 
requests of users. The TMSDIS preview display is initiated by the PRE command. 
Figure 4-7 is an example of the TMSDIS preview display. 



JSN 


TMSVSN STATUS EQ 


PN/VSN 


USERNAM FAMILY RING 


LAB 


LEVEL 


AEQR 


TAPE3 


CT040 CT 


TAPE3 


USER07 KTJ IN 


YES 


LVLO 


AABK 


KTJ001 


NT060 GE 
WRONG VSN 


KTJ001 


USER05 KTJ OUT 
GO, EST TO BLNK LABEL 


YES 


LVLO 


ABCD 


UT0005 


NT061 PE 
MOUNT NEXT 


MYTAPE 
TAPE 


TSMMMAA KIB IN 


YES 


LVL2 


AAAQ 




MOUNT DJ1 


PACK5 


PFUSER PFFAMLY 





LVLO 


ABXJ 


•KTJ056 


MOUNT GE 


KTJ056 


USER 10 KTJ IN 


YES 


LVLO 


AABN 


NON-TMS 


MOUNT MT 


*TAPE1B= 


ASDF246 KCP OUT 


— — 


LVL7 



Figure 4-7. TMSDIS Preview Display 

Each entry on this display has the following format: 

jsn tmsvsn status eq pn/vsn usernam family ring lab level 
Job sequence name of the job requesting a resource. 



jsn 
tmsvsn 



status 



The logical VSN assigned by TMS. The logical VSN might not be the same 
as the physical VSN. This field contains blanks for mass storage requests 
and NON-TMS for tape requests outside of TMS. If the tmsvsn is preceded 
by an asterisk (*), TMS considers the tape to be off-site. 

This field contains MOUNT for mass storage requests and for first volume 
tape requests and the tape equipment type and EST ordinal if an error 
condition or multivolume request occurs on a tape drive. The following 
messages may appear in the second line: 



NEEDS LABEL 
NEEDS LABEL 
ACCESS CONFLICT 
CANNOT ACCESS DATA 
RING CONFLICT 
WRONG VSN 
WRONG VSN 
DRIV CONFLICT 
DENSITY MISMATCH 
MOUNT NEXT TAPE 



GO, EST TO BLNK LABEL 



GO, EST TO BLNK LABEL 
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eq 



Resource type; can be one of the following where i is equal to the number 
of spindles: 



AT 

CT 

DB-i 

DC-i 

DD-i 

DF-i 

DG-i 

DH-i 

Dl-i 

DJ-i 

DK-i 

DL-i 

DM-i 

DN 

DQ-i 

EA-i 

EB-i 

EC-i 

ED-i 

EE-i 

EF-i 

GE 
HD 
MT 
PE 



Cartridge for ACS, 38000-cpi tape unit. 

Cartridge for CTS, 38000-cpi tape unit. 

885-42 disk. 

895 disk. 

834 disk. 

887 4K sector disk. 

836 disk. 

887 16K sector disk. 

844-21 half-track disk. 

844-41/44 half-track disk. 

844-21 full-track disk. 

844-41/44 full-track disk. 

885-11/12 half-track disk. 

9853 disk. 

885-11/12 full-track disk. 

5830 Disk Array Subsystem; one 5832 Solid State Disk (SSD) 
drive used in serial mode. 

5830 Disk Array Subsystem; two 5832 SSD drives used in parallel 
mode. 

5830 Disk Array Subsystem; one 5833 SABRE drive used in serial 
mode. 

5830 Disk Array Subsystem; two 5833 SABRE drives: one for data 
and one for parity. 

5830 Disk Array Subsystem; two 5833 SABRE drives used in 
parallel mode. 

5830 Disk Array Subsystem; three 5833 SABRE drives: two for 
data and one for parity. 

9-track, 6250-cpi tape unit. 

9-track, 800-cpi tape unit. 

7-track magnetic tape unit. 

9-track, 1600-cpi tape unit. 
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pn/vsn 1- to 7- character auxiliary pack name or a 1- to 6- character physical VSN. 

If the pack name or VSN is preceded by an asterisk (*), a device that is 
correctly off is required to satisfy this request. If the VSN has been 
equivalenced by the user in the tape request, an equal sign (=) appears as 
the seventh character. 

usernam User name of the job. 

family Family name of the job. 

ring Write enable status. IN if write ring in for MT or NT tape or if write 

enable thumbwheel set correctly for AT or CT tape. Blank if not 
write- enabled. 

lab Magnetic tape label requirements: 

YES A labeled tape is required. 

blank No label is required. 

level Access level of the file being requested. The tape assigned must allow this 

access level. This field appears on secured systems only. 
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TMSDIS Input Commands 

TMSDIS commands are entered one per input line. The maximum number of characters 
processed for an input line is 77. An input line can be terminated by a period. Any 
characters following the period are ignored. If a parameter requires special characters, 
the parameter can be dollar sign ($) delimited. For example, suppose VSN A$BD + E is 
to be assigned to the tape on equipment 65: 

VSN,65,$A$$BD+E$. 

The following is a list of valid TMSDIS input commands: 



Command 



Description 



ASSIGN,jsn,est. 

COPY. 

EQU. 
FAM. 
GO,est. 



Assigns a tape or null equipment defined by EST ordinal est to the 
job with job sequence name jsn. This command is entered in 
response to a REQUEST message in the JOB display. 

Copies the current display to the output file. This command is 
ignored for screen mode. 

Initiates the TMSDIS tape equipment display. 

Initiates the TMSDIS family catalog display. 

Causes the tape on the tape unit defined by EST ordinal est to be 
automatically blank labeled so it can be assigned to the job. This 
command is entered in response to one of the following status 
messages in the PRE display: 



NEEDS LABEL 



GO, EST TO BLNK. LABEL 



WRONG VSN 



GO, EST TO BLNK LABEL 



HELP. 
JOB. 

+ n. 

-n. 

PRE. 



If the tape should not be blank labeled, enter the STOP.est. 
command to unload the tape. 

Initiates the TMSDIS help display. 

Initiates the TMSDIS executing job display. 

Toggles the display n pages forward. Default is 1. 

Toggles the display n pages backward. Default is 1. 

Initiates the TMSDIS preview display. 
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Command 



Description 



SCRATCH,est. 



STOP.est. 



Declares the tape mounted on an unassigned tape unit defined by 
EST ordinal est to be a scratch tape. This command enables a tape 
to be available to satisfy scratch VSN requests and still be 
assigned to its original VSN. The VSN defined on the tape is not 
redefined as scratch although the VSN appears as SCRATCH in the 
TMSDIS tape equipment display. 

Prevents the tape on the tape unit defined by EST ordinal est from 
being automatically blank labeled and unloads the tape. This 
command is entered in response to one of the following status 
messages in the TMSDIS preview display: 



NEEDS LABEL 



GO, EST TO BLNK LABEL 



WRONG VSN 



GO, EST TO BLNK LABEL 



If the tape should be blank labeled, enter the GO.est. command. 

UNLOAD.est. Physically unloads the tape mounted on the unassigned tape unit 

defined by EST ordinal est. This command is ignored if the tape 
unit is assigned to a job. 

VSN.est. Clears the VSN assigned by the VSN.est,. or VSN.est.vsn. command 

on an unassigned tape unit defined by EST ordinal est. This 
command must be issued before a second VSN.est,. or VSN,est,vsn. 
command is issued for a tape unit. 

VSN.est,. Declares the tape mounted on an unassigned tape unit defined by 

EST ordinal est to be a scratch tape. This command is the same as 
SCRATCH, est. if the tape is unlabeled or if the tape is not written 
on. If a labeled tape is written on, the VSN in the volume 1 label 
of the tape is rewritten as a scratch VSN and the VSN appears as 
***est (est is the ordinal of the tape unit) in the LDISTAT tape 
equipment display. This command is ignored if the tape unit is 
assigned to a job or if a VSN.est,. or VSN,est,vsn. command has 
previously been entered. To clear the effect of a previous VSN.est,. 
command, enter the VSN, est. command. 

VSN.est, vsn. Assigns VSN vsn to an unassigned tape unit defined by EST 

ordinal est. This command is used so that a tape unit can be 
assigned to a job that requests an unlabeled tape with a VSN. This 
command is ignored if the tape unit is assigned to a job, if the 
tape is labeled, or if a VSN.est,. or VSN.est, vsn. command has 
previously been entered. To clear the effect of a previous 
VSN, est, vsn. command, enter the VSN.est. command. 



4-12 NOS 2 Tape Management System (TMS) 



Revision C 



TMS Procedures Installation Parameters 5 

TMSDBLD 5-1 

TMSRBLD 5-2 
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TMS Procedures Installation Parameters g 

TMS provides a series of procedures that allows you to perform various functions with 
a tape catalog file: 



Procedure 



Description 



TMSDBLD Recovers a TMS tape catalog file. 

TMSRBLD Rebuilds a tape catalog file. 

TMSDUMP Dumps a tape catalog file to a different device. 

TMSLOAD Reloads a family's tape catalog file from a different device. 

You must add the following directive to the LIBDECK on your deadstart tape if TMS 
procedures are to run correctly: 

•PROC TMSDBLD , TMSDUMP , TMSLOAD , TMSRBLD 

TMSDBLD 

This procedure uses the account file to generate TFSP directives that can be used to 
recover a TMS tape catalog file. The procedure must be called from a system origin 
job.' 

Format: 

TMSDBLD, f ami 1y,afn,dfn, st ime.etime, SAM, EAM. 

Parameter Description 



family 

afn 

dfn 

stime 

etime 

SAM 
EAM 



Name of the family used to build directives. This parameter is 
required. 

Local file name of the file with TMS recovery messages. If not 
specified, the current account file is used. 

Local file name of TFSP directive file. Default is DIRFILE. If dfn 
is not an empty file, the TFSP directives are copied at the end of 
the file. 

Starting time to begin reading account file. Format is hhmmss. If 
not specified, the account file is read from the beginning. 

Ending time to complete reading account file. Format is hhmmss. If 
not specified, the account file is read to the end. 

If specified, the starting time is after midnight in the account file. 

If specified, the ending time is after midnight in the account file. 



The calling job exits at user index 377777s of the family. 
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The following local file names are used by TMSDBLD: 

ACCFILE 
DIRFILE 

FAMNAME 

The following message is issued to the A,OPERATOR display if TMSDBLD is 
unsuccessful: 

TMSDBLD ABORTED, SEE DAYFILE. 

TMSRBLD 

This procedure can be used to rebuild a tape catalog file given an old tape catalog file 
and a TFSP directive file. The procedure must be called from a system origin job. 

Format: 

TMSRBLD, f ami ly ,ofn,nfn,dfn. 

Parameter Description 

family Family name of the tape catalog file to rebuild. This parameter is 

required. 

ofn Local file name of the old tape catalog file that is rebuilt. If not 

specified, the direct-access file ZZZZZFC on user index 377777 8 of 
the family is used. ZZZZZFC must not be a fast-attached file when 
TMSRBLD is called. 

nfn Local file name of the rebuilt tape catalog file. Default is NEW. 

The ofn and nfn parameters may have the same name. 

dfn Local file name of the TFSP directive input file to apply against 

the old tape catalog file. Default is DIRFILE. 

The calling job exits at user index 377777s of the family. 

The local file name ZZZZZFC is used by TMSRBLD. 

The following message is issued to the A,OPERATOR display if TMSRBLD is 
unsuccessful: 

TMSRBLD ABORTED, SEE DAYFILE. 
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TMSDUMP 

This procedure uses PFDUMP to dump a family's tape catalog file to a different device. 
The procedure must be called from a system origin job. 

Format: 

TMSDUMP , f ami 1 y , df m , du i , dpf . 
Parameter Description 

family Family name of the tape catalog file to dump. This parameter is 

required. 

dfm Name of the family to receive the dump file. Default is the same 

as the family of the tape catalog file. 

dui User index to receive the dump file. Default is 377777g. 

dpf Name of the direct access file to receive the dump. If not specified, 

the dump is copied to local file TAPE. 

The calling job exits at user index 377777 8 of the family. 

The local file name TAPE is used by TMSDUMP. 

The following message is issued to the A.OPERATOR display if TMSDUMP is 
unsuccessful: 

TMSDUMP ABORTED, SEE DAYFILE . 
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TMSLOAD 

This procedure uses PFLOAD to reload a family's tape catalog file from a different 
device. The procedure must be called from a system origin job. 

Format: 

TMSLOAD , f ami 1 y , dfm , du 1 , dpf . 

Parameter Description 

family Family name of the tape catalog file to reload. This parameter is 

required. 

dfm Name of the family that has the dump file. Default is the same as 

the family of the tape catalog file. 

dui User index that has the dump file. Default is 377777 8 . 

dpf Name of the direct access file that has the dump. If not specified, 

the local file TAPE is assumed to be the dumpfile. 

The calling job exits at user index 377777 8 of the family. 

The local file name TAPE is used by TMSLOAD. 

The following message is issued to the A,OPERATOR display if TMSLOAD is 
unsuccessful: 

TMSLOAD ABORTED, SEE DAYFILE. 
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COMSTFM Installation Parameters 



The COMSTFM installation parameters are as follows: 

Line 
Value Default Number Description 



CRDP 



T4984.1 



REMT 



4095 



584 



TMSG 



ACFN 



638 



VUMT 



63 



585 



Number of days that will pass before a 
conditionally released tape becomes 
unconditionally released. (An unconditionally 
released tape is available as a scratch VSN.) If 
CRDP has a value of zero (0), all tape releases 
are unconditional. 

Number of recovered tape errors a VSN can have 
before hold for maintenance status is set on the 
VSN. When a VSN is in hold status, it is not 
available as a scratch tape. If REMT has a value 
of zero (0), the system ignores the number of 
recovered errors. 

Destination of TMS recovery messages. A value 
of ACFN specifies the account dayfile. A value of 
ERLN specifies the error log. A value of zero (0) 
specifies that no TMS recovery messages are to 
be issued. 

Number of times a user can access a VSN before 
hold for maintenance status is set on the VSN. 
When a VSN is in hold status, it is not available 
as a scratch tape. If VUMT has a value of zero 
(0), the system ignores the number of user 
accesses. 



Conditional Release Delay Period 

A conditional release delay period can be set up to cause a delay between when a user 
releases a tape and when the tape returns to the scratch pool (is unconditionally 
released). The conditional release delay period is defined by the symbol CRDP in 
common deck COMSTFM. A conditionally released tape is unconditionally released if 
the following equation is true: 

Current Date - Release Date > CRDP 

If the site is running with conditional user release, a user may make a request to site 
personnel to restore a conditionally released tape file. The user is required to inform 
site personnel whether the tape file to be restored should be symbolic or nonsymbolic. 

When the TMSON command is used to make the family tape catalog file a 
fast-attached file and when the TFSP ISV directive is used to initialize scratch VSNs, 
the system unconditionally releases all tape files that have been conditionally released 
for more than the conditional release delay period. 
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TMS Messages A 

This appendix contains a sorted listing of all TMS messages that could be of 
importance to the operator. Each message is followed by an explanation of the message 
and/or the circumstances causing it to be issued, the recommended operator action, and 
the routine that issued the message. 

Lowercase letters are used within a message to identify fields that are variable. All 
messages beginning with lowercase (variable) fields are listed alphabetically according 
to the first nonvariable field. 

ABNORMAL TERMINATION, ERROR CODE = nn. 

Description: The system returned an error nn that TFSP could not recognize. If this message is issued, 
contact a knowledgeable person at your site. 

Issued by TFSP. 
User Action: Contact a knowledgeable person at your site. 

xxxxxxx ACTIVITY SUSPENDED. 

Description: Temporary interruption of tape catalog activity. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

xxxxxxx ALREADY RESERVED. 

Description: When creating a new symbolic access file, the file was found in the user's catalog. 

Issued by TFM. 
User Action: Try another file name. 

ALTERNATE USER ADMIT UPDATED. 

Description: The admit entry for a previously admitted alternate user has been updated using the ADMIT 
directive. 

Issued by TFSP. 

User Action: Informative message. 

ALTERNATE USER ADMITTED. 

Description: A new alternate user has been admitted using the ADMIT directive. 

Issued by TFSP. 
User Action: Informative message. 

ALTERNATE USER CURRENTLY IS ADMITTED. 

Description: The user name specified by the AUDER directive has been admitted previously. 

Issued by TFSP. 
User Action: Informative message. 

ALTERNATE USER NOT CURRENTLY ADMITTED. 

Description: The user name specified by the AUSER directive has not been previously admitted. 

Issued by TFSP. 
User Action: Informative message. 

ALTERNATE USER NOT PROCESSED. 

Description: An alternate user DROP directive has been issued. 

Issued by TFSP. 
User Action: Informative message. 
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BUFFER ARGUMENT ERROR. 

Description: The buffer pointers are invalid or out of range. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

CANNOT CHANGE TAPE TYPE/DENSITY 

Description: Either an attempt was made to change the tape type of a VSN entry already in the catalog, or 
an attempt was made to change the density of a tape file assigned VSNs and the new density implied a 
change in tape type. 

User Action: It is not possible to change an easting VSN or tape file in this way. To define a VSN or tape 
file with this attribute, first delete the existing entry and then create a new VSN or tape file. 

CANNOT CHANGE SYSTEM VSN FLAG 

Description: An attempt was made to change the system VSN flag of a VSN entry already in the catalog. 

User Action: It is not possible to change an existing VSN entry in this way. To define a VSN or tape file 
with this attribute, first delete the existing entry and then create a new entry. 

xxxxxxx CATALOG ERROR. 

Description: Family Tinmririnnr tape catalog is unusable. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

CATALOG ERROR REQUIRED WITH *CLEAR*. 

Description: The TFSPE command was issued with the clear parameter for a tape catalog file that did not 
have a tape catalog error. 

Issued by TFSP. 

User Action: Try a tape catalog file on another family. 

CATALOG LINKAGE ERROR. 

Description: TFM internal error. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

xxxxxxx CATALOG NOT FOUND. 

Description: TMS is enabled but the family xxxxxxx tape catalog could not be found. 

Issued by TFM. 
User Action: Contact central site to find out when catalog will be available. 

*CF* PARAMETER REQUIRED WITH *CLEAR*. 

Description: The TFSPE command was issued with the clear parameter but without the CF parameter. 

Issued by TFSP. 
User Action: Add the CF=filenam parameter to the TFSPE command. 
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DEADLOCK. 

Description: An attempt was made to access a file that is currently assigned to this job and interlocked 
busy. 

Issued by TFM. 

User Action: Contact a knowledgeable person at your site. m 

DIRECTIVE ERRORS. 

Description: Errors were encountered while processing the directives. Consult the output listing for reason. 

Issued by TFSP. 
User Action: Correct and rerun. 

EMPTY CATALOG. 

Description: Audit of the users catalog where none exists. 

Issued by TFM. 
User Action: None. 

EMPTY TAPE CATALOG FILE. 

Description: The file specified by the P parameter is a zero-length file. 

Issued by TFSP. 
User Action: Make the tape catalog file local 
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EOI NOT ON TRACK CHAIN. 

Description: Cannot locate end of information when extending the catalog. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

ERRONEOUS BUFFER POINTER. 

Description: TFM internal error. 

Issued by TFM. 
User Action: Contact central site to find out when TMS will be enabled. 

♦ERROR* ASSIGNED VSNS AT MAXIMUM. 

Description: An attempt was made to assign more than 60 vsns to a tape file or to assign a vsn to a tape 
file that was not the last file of a multifile set. 

Issued by TFSP. 

User Action: Do not assign vsn to this. 

♦ERROR* DATA FIELD ERROR. 

Description: The data specified with the directive is not valid for that directive. 

Issued by TFSP. 
User Action: Correct and retry. 

♦ERROR* DIRECTIVE INCORRECT FROM CURRENT LEVEL. 

Description: The directive is valid only on the level in which it is defined and it was issued from a lower 
level. 

Issued by TFSP. 

User Action: Correct and retry. 

♦ERROR* FILE ALREADY RESERVED. 

Description: An attempt was made to issue the RESERVE directive for a tape file that already was 
reserved. 

Issued by TFSP. 

User Action: Use the AMEND directive. 

♦ERRORS FILE BUSY. 

Description: The tape file entry specified by the FILE or FILEV directive is in use and cannot be accessed 
at this time. 

Issued by TFSP. 

User Action: Try again later. 

♦ERROR* FILE IDENTIFIER CONFLICT. 

Description: The file identifier specified by the FI directive is the same as the file identifier for another of 
the symbolic access files of the user. 

Issued by TFSP. 

User Action: Use another file identifier. 

♦ERRORS FILE NAME CONFLICT. 

Description: The file name specified by the READ directive is the same as a file used by one of the 
command parameters. 

Issued by TFSP. 

User Action: Correct and retry. 
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♦ERROR* FILE NOT IN CATALOG. 

Description: The tape file specified by the RELEASF or RELEASV directive is not among the tape files of 

the user. 

Issued by TFSP. 
User Action: Use AUDITON directive to check valid vsn and/or file identifiers. 

♦ERROR* FILE NOT RESERVED. 

Description: An attempt was made to issue the AUSER or AMEND directive for a tape file that is not yet 
reserved. 

Issued by TFSP. 

User Action: Use the RESERVR directive. 

ERROR IN CATALOG DATA. 

Description: The catalog entry data contains information which does not pass validation. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

ERROR IN FILE DATA. 

Description: An attempt was made to access a tape file that has an unrecovered read/write error or 
non-matching tape label information between the tape label and the tape catalog. 

Issued by TFM. 

User Action: Correct error condition and retry. 

ERROR IN INDEX DATA. 

Description: The catalog VSN or username index is in error. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

♦ERROR* INCORRECT DIRECTIVE. 

Description: Either the directive is not a TFSP directive or it cannot be issued at this point in the directive 
stream. 

Issued by TFSP. 

User Action: Correct and retry. 

*ERROR* INCORRECT SEQUENCE NUMBER. 

Description: The sequence number specified by the FILEV directive is too large. 

Issued by TFSP. 
User Action: Use a smaller sequence number. 

•ERROR* NO SCRATCH AVAILABLE. 

Description: An attempt was made to assign the next scratch tape but there are no scratch tapes left in the 
catalog. 

Issued by TFSP. 

User Action: Add new scratch vsns. 

♦ERROR* NON-MATCHING STATUSES. 

Description: The status of the vsn specified by the AVSN directive does not match the status of the first vsn 
of the tape file. 

Issued by TFSP. 

User Action: Use a different vsn or change vsn status. 
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♦ERROR* READ DIRECTIVE INVALID. 

Description: An attempt was made to issue the READ directive from the file being read by a previous 
READ directive. 

Issued by TFSP. 

User Action: Issue read directly from input file. 

♦ERRORS REQUIRED DATA MISSING. 

Description: An attempt was made to reserve a tape file entry without a vsn. 

Issued by TFSP. 
User Action: Correct and retry. 

♦ERROR* VALIDATED USERS AT MAXIMUM. 

Description: An attempt was made to add a ninth validated user via the VALID AT directive. 

Issued by TFSP. 
User Action: Delete a validated user with the incorrect directive. 

*ERROR* VSN ALREADY ASSIGNED. 

Description: The VSN specified by a REMOVE or AVSN directive is assigned to a tape file entry. 

Issued by TFSP. 
User Action: Try another vsn. 

♦ERROR* VSN ALREADY IN CATALOG. 

Description: An attempt was made to issue the ADD directive for a vsn that had already been added to the 
tape catalog file. 

Issued by TFSP. 

User Action: Use the REVISR directive. 

*ERROR* VSN ALREADY RESERVED BY USERNAM. 

Description: The vsn specified by the VSN directive is assigned to a tape file of user name usernam. 

Issued by TFSP. 
User Action: Try another VSN. 

♦ERROR* VSN BUSY. 

Description: The vsn specified by the VSN or AVSN directive is in use and cannot be accessed at this time. 

Issued by TFSP. 
User Action: Try again later. 

♦ERROR* VSN NOT ADDED TO CATALOG. 

Description: An attempt was made to issue the REVISE directive for a vsn that had not yet been added to 
the tape catalog file. 

Issued by TFSP. 

User Action: Use the add directive. 

*ERROR* VSN NOT ADDED TO FILE. 

Description: The vsn specified by the RELEASE directive is not assigned to a tape file. 

Issued by TFSP. 
User Action: Use AUDITVS directive to check status of vsns. 

♦ERROR* VSN NOT AVAILABLE. 

Description: The vsn specified by the FILEV directive is either not in the tape catalog or is assigned to 
another user. 

Issued by TFSP. 

User Action: Use AUDITVS directive to check status of vsns. 
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♦ERROR* VSN NOT IN CATALOG. 

Description: The vsn specified by a PURGE, RELEASE, or AVSN directive is not in the tape catalog file. 

Issued by TFSP. 
User Action: Try another vsn. 

FAMILY NOT ACTIVE. 

Description: A fast-attached file named ZZZZZFC was not found on the family. 

Issued by TFSP. 
User Action: Try IFS,E= ZZZZZFC on that family. 

FAMILY NOT FOUND. 

Description: The specified family on the TMSON or TMSOFF command is not active on the system. 

Issued by LDISTAP. 
User Action: Use a different family name or mount the device with that family name. 

FILE AMENDED. 

Description: The AMEND directive has been issued for a tape file that previously was reserved. 

Issued by TFSP. 
User Action: Informative message. 

FILE CURRENTLY IS RESERVED. 

Description: The tape file specified by the FILE directive has been previously reserved. 

Issued by TFSP. 
User Action: Informative message. 

FILE NAME CONFLICT ■ LFN. 

Description: Specified file used for more than one purpose. Only the P and N parameters can specify the 

same file name. 

Issued by TFSP. 
User Action: Correct and retry. 

FILE NOT CURRENTLY RESERVED. 

Description: The tape file specified by the FILE directive has not been previously reserved. 

Issued by TFSP. 
User Action: Informative message. 

FILE NOT PROCESSED. 

Description: The file level DROP directive has been issued. 

Issued by TFSP. 
User Action: Informative message. 

FILE RELEASED. 

Description: The RELEASE, RELEASF, or RELEASV directive has completed. 

Issued by TFSP. 
User Action: Informative message. 

FILE RESERVED. 

Description: The RESERVED directive has been issued for a tape file that previouly was not reserved. 

Issued by TFSP. 
User Action: Informative message. 
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I PARAMETER IGNORED. 

Description: First message issued whenever TFSP is run with the OP=K or OP=Z option. 

Issued by TFSP. 
User Action: Informative message. 

IAUM/SFBM COMPARE ERROR. 

Description: TFM internal error. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

INCORRECT ACCESS. 

Description: User who was not validated attempted to access the family tape catalog file. 

Issued by TFSP. 
User Action: Run at system origin or from a valid user name. 

INCORRECT COMMAND. 

Description: TMSON or TMSOFF was called by a non-system origin job or a user that is not validated for 
TFSP attempted to use TMSDIS from a non-system origin job. 

Issued by LDISTAP. 

User Action: Issue the command from system origin or from different user name. 

INCORRECT EST PARAMETER 

Description: The EST parameter specified for an ASSIGN command was not an EST ordinal of a tape or 
null equipment. 

Issued by LDISTAP. 

User Action: Correct and retry. 

INCORRECT INCREMENT. 

Description: The page increment specified with the + or - command was not a number. 

Issued by LDISTAP. 
User Action: Correct and retry. 

INCORRECT JSN PARAMETER. 

Description: The JSN parameter specified for an ASSIGN command was not a 3- or 4-character job sequence 
number. 

Issued by LDISTAP. 

User Action: Correct and retry. 

INCORRECT OPTION - OP. 

Description: The specified option is not allowed with the OP parameter. 

Issued by TFSP. 
User Action: Correct and rerun. 

INCORRECT TAPE EST PARAMETER. 

Description: The EST parameter specified for a GO, SCRATCH, STOP, or VSN command was not an EST 
ordinal of a tape equipment. This message can also be issued for the VSN.EST,. or VSN,EST,VSN. 
command if the tape on equipment EST is labeled or if a previous VSN, EST,, or VSN,EST,VSN. 
command has not been cleared by a VSN,EST. command. 

Issued by LDISTAP. 

User Action: Check the EQU display to identify the tape EST ordinals. 
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INCORRECT VALUE FOR PP PARAMETER - vwww. 

Description: The value vwww cannot be used for parameter PP on the TMSON, TMSOFF, or TMSDIS 

command. 

Issued by LDISTAP. 
User Action: Correct and retry. 

INCORRECT VSN PARAMETER. 

Description: The VSN parameter specified for a VSN command was not a 1- to 6-character vsn. 

Issued by LDISTAP. 
User Action: Correct and retry. 

JOB NOT REQUESTING RESOURCE. 

Description: The job specified by the JSN parameter for the ASSIGN command was not at a control point 

requesting a resource assignment. 

Issued by LDISTAP. 
User Action: Check the job display to find the jsn of the job requesting a resource. 

L-DISPLAY NOT AVAILABLE. 

Description: TMSDIS cannot use L-display mode at this time because another job has interlocked the 

L-display. 

Issued by LDISTAP. 
User Action: Terminate the current L-display utility. 

LAST COMMAND. 

Description: Indicates last command processed without errors. 

Issued by LDISTAP. 
User Action: None. 

LINKED CATALOG NOT ACCESSIBLE. 

Description: The linked catalog cannot be accessed from the current family. 

Issued by TFM. 
User Action: Check the family name specified. Call customer services for status information if family name 

is correct. 

MAGNET NOT ACTIVE. 

Description: The GO, SCRATCH, STOP, UNLOAD, or VSN command was issued when magnet was not 

active. 

Issued by LDISTAP. 
User Action: Bring up the MAG subsystem. 

MASS STORAGE ERROR. 

Description: Mass storage read or write error on the catalog. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

MULTIFILE PROCESSING ERROR. 

Description: Multi-file request or unlabeled tape. 

Multi-file request of file with nonstandard labels. 

Issued by TFM. 
User Action: Use non-multi-file processing. 
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Description: Audit of alternate access user's produced an empty file. II 

Issued by TFM. §f| 

User Action: None. §§§ 

NO EXTEND OF USER-OWNED FILE. 

Description: End of table on write to a user-owned file and no next vsn could be found. 

Issued by TFM. 
User Action: Contact central site to add a user-owned volume. 

NO SCRATCH TAPES. 

Description: The tape scratch count is zero. 

Issued by TFM. 
User Action: Add scratch tapes to your database. 

fflenam NOT FOUND. 

Description: Local file name filenam used in conjunction with GETVSN or RESERVE was not found in the 
system or was found assigned to another job. 

Issued by TFM. 

User Action: Try another file name. 

xxxxxxx NOT FOUND. 

Description: For a selective audit of an admitted user, the user name could not be located in the audit 
entries associated with the file. 

Issued by TFM. 

User Action: Try another user name. 

xxxxxxx NOT FOUND. 

Description: When accessing a file by file name, it could not be found in the user's catalog or an alternate 
user did not have permission to access the file. 

Issued by TFM. 

User Action: Try another file name. 

filenam NOT ON MAGNETIC TAPE. 

Description: The local file name filenam, used in conjunction with GETVSN or RESERVE, was located and 

assigned to the job but is not magnetic tape equipment. 

Issued by TFM. 
User Action: Try another file name. 

P AND N PARAMETERS IGNORED. 

Description: First message issued whenever TFSP is not run in local file (LF) mode. 

Issued by TFSP. 
User Action: Informative message. 

PARAMETER ERROR - PARAM. 

Description: The specified parameter is not a TFSP parameter. 

Issued by TFSP. 
User Action: Correct and rerun. 

PREMATURE END OF FILE, filenam. 

Description: A null input line was found while reading directives from file file nam 

Issued by TFSP. 
User Action: Informative message. 
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PROCESSING. 

Description: Indicates current command is being processed. 

Issued by LDISTAP. 
User Action: None. 

xxxxxxxx RANDOM ACCESS ERROR. 

Description: TFM internal error. Relative disk address mnmnnnc is not within the bounds of the catalog. 

Issued by TFM. 
User Action: Contact a knowledgeable person at your site. 

SYSTEM VSN CANNOT BE USER-OWNED 

Description: Either an attempt was made to change the ownership of a VSN entry from CENTER to USER 
for a VSN entry with the system VSN flag set, or an attempt was made to set the system VSN flag for 
a user-owned VSN entry. 

User Action: Do not attempt to do this. 

TAPE CATALOG FILE INTERLOCKED. 

Description: Another TFSP job is accessing the tape catalog file of the family. 

Issued by TFSP. 
User Action: Try again later. 

TFM INCORRECT REQUEST. 

Description: The request did not pass validation. One of the following condition exists. 

ADMIT of user name of the files owner. 

ADMIT request with invalid access mode. 

ADMIT request of public access file. 

AUDIT request with invalid search type. 

GETVSN or RESERVE request of a non-TMS controlled file. 

AMEND request with invalid list attribute. 

AMEND request with invalid file category. 

AMEND request with invalid access mode. 

ADMIT, AMEND, and RESERVE require the first volume of a multivolume set to be specified. 

Issued by TFM. 
User Action: Correct and retry. 

TFM UTILITY ACTIVE. 

Description: Catalog interlocked by TFSP. 

Issued by TFM. 
User Action: Try again later. 

TFSP ABORTED. 

Description: Control point error flag is set. Consult dayfile listing for reason. 

Issued by TFSP. 
User Action: Correct and rerun. 
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TFSP COMPLETE. 

Description: TFSP normal completion. 

Issued by TFSP. 
User Action: None. 

TFU - ARGUMENT ERROR. 

Description: The parameter specified in the lower 24 bits of the request is not in the correct format for the 
function. For example, a parameter block address may be outside the field length of the calling 
program. 6 

Issued by TFU. 

User Action: Correct and retry. 
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TFU • INCORRECT REQUEST. 

Description: The function number specified is not recognized by TFU. 

Issued by TFU. 
User Action: Correct and retry. 

TFU • USER ACCESS NOT VALID. 

Description: The function requested requires special privileges that the calling program does not have. For 
example, the function may require an SSJ = entry point. 

Issued by TFU. 

User Action: Try another function. 

TMS DISABLED. 

Description: The tape file manager was called with TMS disabled. 

Issued by TFM. 
User Action: Correct and retry. 

TMS PROCESSING INHIBITED. 

Description: Assignment request by a system origin job and no TO = T specified. 

Assignment request by a nonsystem origin job and TO=F specified. 

Issued by TFM. 
User Action: None. 

TMSDIS COMPLETE. 

Description: TMSDIS normal termination. 

Issued by LDISTAP. 
User Action: None. 

TOO MANY PARAMETERS. 

Description: More parameters were specified than the command allows. 

Issued by LDISTAP. 
User Action: Correct and retry. 

UNABLE TO PROCESS REQUEST. 

Description: Because of system activity the GO, SCRATCH, STOP, UNLOAD, or VSN commands cannot be 
processed at this time. 

Issued by LDISTAP. 

User Action: Try again later. 

UNABLE TO TURN OFF *TMS* CATALOG FOR fffffff. 

Description: The TMS catalog for family fffffff cannot be turned off at this time. 

Issued by LDISTAP. 
User Action: Ensure that there is no activity on the family. 

UNABLE TO TURN ON *TMS* CATALOG FOR fffffff. 

Description: The TMS catalog for family fffffff cannot be turned on at this time. 

Issued by LDISTAP. 
User Action: Ensure that direct-access file ZZZZZFC exists on user index. 

UNEXPECTED TAPE CATALOG ERROR. 

Description: The PP program TFM returned an error code that TFSP was not expecting. If this message is 
issued while working on a fast-attached tape catalog file, contact a knowledgeable person at your site. 

Issued by TFSP. 

User Action: Contact a knowledgeable person at your site. 
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UNKNOWN COMMAND. 

Description: The command specified cannot be processed by TMSDIS. 

Issued by LDISTAP. 
User Action: Correct and retry, 

UNKNOWN PARAMETER - PP. 

Description: The parameter PP cannot be processed by the TMSON, TMSOFF, or TMSDIS command. 

Issued by LDISTAP. 
User Action: Correct and retry. 

USER LEVEL COMPLETE. 

Description: The user level DROP directive has been issued. 

Issued by TFSP. 
User Action: Informative message. 

VSN ADDED TO CATALOG. 

Description: The ADD directive has been issued for a VSN that has not been previously added to the tape 
catalog file, the tape catalog file. 

Issued by TFSP. 

User Action: Informative message. 

VSN xxxxxx BUSY. 

Description: The VSN requested, or a vsn that is part of a multifile set is currently assigned to another job. 

Issued by TFM. 
User Action: Try again later. 

VSN CURRENTLY IN CATALOG. 

Description: The VSN specified by the VSN directive has previously been added to the tape catalog file. 

Issued by TFSP. 
User Action: Informative message. 

VSN INTERLOCKED. JSN IS jsn. 

Description: The VSN specified by the VSN directive is being requested. The jsn of the job requesting the 

tape is given. 

Issued by TFSP. 
User Action: Informative message. 

VSN NOT CURRENTLY IN CATALOG. 

Description: The VSN specified by the VSN directive has not been previously added to the tape catalog file. 

Issued by TFSP. 
User Action: Informative message. 

VSN NOT PROCESSED. 

Description: The VSN level DROP directive has been issued. 

Issued by TFSP. 
User Action: Informative message. 

VSN REMOVED FROM CATALOG. 

Description: The REMOVE directive has completed. 

Issued by TFSP. 
User Action: Informative message. 
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VSN REVISED. 

Description: The REVISE directive has been issued for a VSN that has been previously added to the tape 
catalog file. 

Issued by TFSP. 

User Action: Informative message. 

WAIT SCRATCH ASSIGNMENT. 

Description: Request for scratch and none could be found. 

Issued by TFM. 
User Action: Wait until scratch is assigned. 

WRITE REQUEST ON READ-ONLY FILE. 

Description: Alternate user attempting to write to a file with read only mode. 

Issued by TFM. 
User Action: Contact file originator. 
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B 



The following messages can be issued to the account file by TMS. These messages are 
used by the TMS recovery procedures TMSDBLD and TMSRBLD to rebuild TMS 
catalog files and appear whenever any of the following actions take place. 



Message 



Description 



SOAD , family, vsn, prn, ssssss. 

SDAM , family, user nam, fvsn, ssssss. 

SDAU , faml ly/usernam/seqno/fvsn, vsn. 

SDCR , famlly/usernam/seano/fvsn. 

SDCR , fami ly/usernam/seqno/fvsn, . 



SDCR , fami ly/usernam/seqno/fvsn, 
yy/mm/dd . 

SDRA , fam11y/usernam/seqno/vsn, 
tfd/passwor. 

SDRA , f ami 1 y/usernam/seqno/vsn , tfd. 



SDRB , familyw'logical-file-idntx 2 
Dhysical-f ile-idt . 

SDRC , fami 1 y/ control wrdyVchrgnumber , 
mulsldz. 4 

SDRM , family, vsn. 

SDRV , family, vsn, prn, ssssss. 



VSN is added to a tape catalog file. 

Tape file is amended. 

VSN is assigned to a tape file of a user. 

Tape file is unconditionally released. 

Conditional release date is cleared from a 
tape file. 

Tape file is conditionally released. 
Tape file is reserved or amended. 



Tape file is reserved or amended and 
password is null. 

Tape file is reserved or amended. 



Tape file is reserved or amended. 

VSN is removed from a tape catalog file. 
VSN is revised in a tape catalog file. 



1. w is the character susbtituted for the colon after family identifier. 

2. z is the character susbtituted for the colon after logical-file-idnt. 

3. y is the character susbtituted for the colon after controlwrd. 

4. z is the character susbtituted for the colon after mulsid. 
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The variable fields of the previous messages have the following meanings: 
Field Description 



chrgnumber 

controlwrd 

fami ly 

fvsn 

logical-f11e-ldnt 

mulsid 

passwor 

physical-f1 le-idt 

prn 

seqno 

ssssss 



tfd 

usernam 
vsn 

yy/mm/dd 
NOTE 



Owner charge number of VSN. 

Control word for VSN. 

Family name of tape catalog file. 

First VSN of the tape file. 

Logical file identifier for symbolic access tape. 

Multiset identifier for symbolic access tape. 

' Password assigned to the tape file. 

Physical file identifier for symbolic access tape. 

Physical reel number of VSN. 

Sequence number of the tape file that the VSN was 
assigned to or the tape file that was released. 

6-digit octal number representing VSN status: 

000002 Read/write error detected. 

000010 VSN transferred off-site. 

010000 User-owned file volume. 

200000 Hold for maintenance. 

Three characters of encoded data for the tape label 
type, track and density, data conversion mode, and 
tape format. 

User name of the owner of the tape file. 

VSN that is assigned, added, removed, or revised. 

Date that a tape file was conditionally released. 



These messages are not issued when TFSP is running in local file (LF) mode. 



B-2 NOS 2 Tape Management System (TMS) 



Revision C 



Index 



Index 



Account dayfile messages B-l 
Alternate user level directives 
AUTO command 2-1 



3-33 



Catalog error 2-2, 4 
Commands 

NOS 1-1 

TFSP 3-1 

TFSPE 3-40 

TMS 1-1; 2-2 
COMSTFM installation parameters 5-5 
Conditional release delay period 5-5 



D 



3-7 



Directive processing options 
Directives 

Alternate user level 3-4, 33 

Family level 3-4, 18 

File level 3-4, 26 

Output format 3-34 

User level 3-4, 24.1 

VSN level 3-4, 22 
Displays 

TFSP 3-8 

TMSDIS 4-3 



E 

EXIT processing 2-1 



Family level directives 3-18 
File level directives 3-26 



M 

Machine-readable file 3-36 
MAGNET command 2-1 
Magnetic tape executive (MAGNET) 2-1 
MAINTENANCE command 2-1 



N 

NOS commands 1-1 



Procedures 

TMSDBLD 5-1 
TMSDUMP 5-3 
TMSLOAD 5-4 
TMSRBLD 5-2 



Tape catalog file 3-1 
Tape display utility (TMSDIS) 1-2; 4-1 
Tape file supervisor (TFSP) 1-2; 3-1 
Tape management system (TMS) 1-1 
Tape processing 
Non-TMS 1-1 
TMS 1-2 
TFSP 

Abort and recovery 3-39 
Command 3-1 
Directives 3-4 

Alternate user level 3-33 
Audit output formats 3-34 
Example 3-7 
Family level 3-18 
File level 3-26 
Keyword values 3-17 
Level structure 3-4 
Processing options 3-7 
Rules 3-5 
User level 3-24.1 
VSN level 3-22 
Displays 3-8 

Alternate user level 3-16 
AUDITAU 3-34 
AUDITUN 3-35 
AUDITVS 3-36 
Family level 3-9 
File level 3-13 
User level 3-12 
VSN level 3-11 
Examples 3-3 
Logical record format 3-36 
Tape file supervisor 1-2; 3-1 
TFSPE command 3-40 
TFSPE parameters 3-40 
TMS 

Commands 1-1; 2-2 
Disabled 2-1 
Enabling 2-1 
Messages A-l 
Procedures 5-1 
Tape catalog file 1-2 
Tape management system 1-1 
TMSBLD procedure 5-1 



60463350 D 



NOS 2 Tape Management System (TMS) Index! 



TMSDIS 



VSN level directives 



TMSDIS 

Command 4-2 
Displays 4-3 

Executing job display 4-7 
Family catalog display 4-6 
HELP display 4-3 
Input commands 4-11 
Preview display 4-8 
Tape display utility 1-2; 4-1 
Tape equipment display 4-4 
TMSDUMP procedure 5-3 
TMSLOAD procedure 5-4 
TMSOFF command 2-4 



TMSON command 2-2 
TMSRBLD procedure 5-2 

U 

Unconditional release 3-32 
User level directives 3-24.1 



VSN level directives 3-22 



Index-2 NOS 2 Tape Management System (TMS) 



60463350 D 



Comments (continued from other side) 



Please fold on dotted line; 
seal edges with tape only. 



FOL3 



OLD 



FOLD 



NO POSTAGE 

NECESSARY 

IF MAILED 

IN THE 

UNITED STATES 



BUSINESS REPLY MAIL 

First-Class Mail Permit No. 4760 St. PauL MN 



POSTAGE WILL BE PAID BY ADDRESSEE 

CONTROL DATA 

Technical Publications ARH219 
4201 Lexington Avenue N. 
St PauLMN 55126-9983 




l.l.l..l.l.i..ll..l,l.ll„l,|„|,|„l..l...l|„,|,|| 



NOS 2 Tape Management System (TMS) 60463350 D 

We would like your comments on this manual to help us improve it Please take a few minutes to fill out 
this form. 

Who are yon? How do you use this manual? 

□ Manager □ As an overview 

□ Systems analyst or programmer Q To learn the product or system 

□ Applications programmer □ For comprehensive reference 

□ Operator □ For quick look-up 

□ Other □ Other 

What programming languages do you use? 



How do you like this manual? Answer the questions that apply. 



Yes Somewhat No 
□ □ □ Does it tell you what you need to know about the topic? 

Is the technical information accurate? 

Is it easy to understand? 

Is the order of topics logical? 

Can you easily find what you want? 

Are there enough examples? 

Are the examples helpful? (□ Too simple? □ Too complex?) 

Do the illustrations help you? 

Is the manual easy to read (print size, page layout, and so on)? 

Do you use this manual frequently? 



□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


D 


□ 


□ 


□ 


D 


D 


D 


□ 


□ 
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□ 
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Please send program listing and output if applicable to your comment. 



jtaczoM 



